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Foreword 



CP/M-68K™ is a single-user general purpose operating system. 
It is designed for use with any disk-based computer using a Motoro 
MC68000 or compatible processor. CP/M-68K is modular in design, and 
can be modified to suit the needs of a particular installation. 

The hardware interface for a particular hardware environment is 
supported by the OEM or CP/M-68K distributor. Digital Research 
supports the user interface to CP/M-68K as documented in the CP/M- 
68K Operating System User's Guide . Digital Research does not 
support any additions or modifications made to CP/M-68K by the OEM 
or distributer. 



Purpose and Audience 

This manual is intended to provide the information needed by a 
systems programmer in adapting CP/M-68K to a particular hardware 
environment. A substantial degree of programming expertise is 

assumed on the part of the reader, and it is not expected that 
typical users of CP/M-68K will need or want to read this manual. 

Prerequisites and Related Publications 

In addition to this manual, the reader should be familiar with 
the architecture of the Motorola MC68000 as described in the 
Motorola 16-Bit Microprocessor User's Manual (third edition), the 
CP/M-68K User ' s and Programmer's Guides , and, of course, the details 
of the hardware environment where CP/M-68K is to be implemented. 

How This Book is Organized 

Section 1 presents an overview of CP/M-68K and describes its 
major components. Section 2 discusses the adaptation of CP/M-68K 
for your specific hardware system. Section 3 discusses bootstrap 
procedures and related information. Section 4 describes each BIOS 
function including entry parameters and return values. Section 5 
describes the process of creating a BIOS for a custom hardware 
interface. Section 6 discusses how to get CP/M® working for the 
first time on a new hardware environment. Section 7 describes a 
procedure for causing a command to be automatically executed on cold 
boot. Section 8 describes the PUTBOOT utility, which is useful in 
generating a bootable disk. 

Appendix A describes the contents of the CP/M-68K distribution 
disks. Appendixes B, C, and D are listings of various BlOSes. 
Appendix E contains a listing of the PUTBOOT utility program. 
Appendix F describes the Motorola S-record representation for 
programs. 
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Section 1 
System Overview 



1.1 Introduction 



CP/M-68K is a single-user, general purpose operating system 
for microcomputers based on the Motorola MC68000 or equivalent 
microprocessor chip. It is designed to be adaptable to almost any 
hardware environment, and can be readily customized for particular 
hardware systems. 

CP/M-68K is equivalent to other CP/M systems with changes 
dictated by the 68000 architecture. In particular, CP/M-68K 
supports the very large address space of the 68000 family. The 
CP/M-68K file system is upwardly compatible with CP/M-80™ version 
2.2 and CP/M-86® Version 1.1. The CP/M-68K file structure allows 
files of up to 32 megabytes per file. CP/M-68K supports from one 
to sixteen disk drives with as many as 512 megabytes per drive. 

The entire CP/M-68K operating system resides in memory at all 
times, and is not reloaded at a warm start. CP/M-68K can be 
configured to reside in any portion of memory above the 68000 
exception vector area (OH to 3FFH) . The remainder of the address 
space is available for applications programs, and is called the 
transient program area, TPA. 

Several terms used throughout this manual are defined in 
Table 1-1. 





Table 1-1. CP/M-68K Terms 


Term 


Meaning 


nibble 


4-bit half-byte 


byte 


8-bit value 


word 


16-bit value 


longword 


32-bit value 


address 


32-bit identifier of a storage 
location 


offset 


a value defining an address in 
storage; a fixed displacement from 
some other address 
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Table 1-1. (continued) 



Term 


Meaning 


text segment 


program section containing machine 




instructions 


data segment 


program section containing 




initialized data 


block storage 


program section containing 


segment (bss) 


uninitialized data 


absolute 


describes a program which must reside 




at a fixed memory address. 


relocatable 


describes a program which includes 




relocation information so it can be 




loaded into memory at any address 



The CP/M-68K programming model is described in detail in the 
CP/M-68K Operating System Programmer's Guide. To summarize that 

model briefly, CP/M-68K supports four segments within a program: 
text, data, block storage segment (bss), and stack. When a program 
is loaded, CP/M-68K allocates space for all four segments in the 
TPA, and loads the text and data segments. A transient program may 
manage free memory using values stored by CP/M-68K in its base page. 
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HARDWARE ENVIRONMENT 
Figure 1-1. CP/M-68K Interfaces 



1.2 CP/M-68K Organization 

CP/M-68K comprises three system modules: the Console Command 
Processor (CCP) the Basic Disk Operating System (BDOS) and the Basic 
Input/Output System (BIOS) . These modules are linked together to 
form the operating system. They are discussed individually in this 
section. 



1.3 Memory Layout 

The CP/M-68K operating system can reside anywhere in memory 
except in the interrupt vector area (OH to 3FFH) . The location of 
CP/M-68K is defined during system generation. Usually, the CP/M-68K 
operating system is placed at the top end (high address) of 
available memory, and the TPA runs from 400H to the base of the 
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1.3 Memory Layout 



operating system. It is possible, however, to have other 
organizations for memory. For example, CP/M-68K could go in the low 
part of memory with the TPA above it. CP/M-68K could even be placed 
in the middle of available memory. 

However, because the TPA must be one contiguous piece, part 
of memory would be unavailable for transient programs in this case. 
Usually this is wasteful, but such an organization might be useful 
if an area of memory is to be used for a bit-mapped graphics device, 
for example, or if there are ROM-resident routines. The BIOS and 
specialized application programs might know this memory exists, but 
it is not part of the TPA. 
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Figure 1-2. Typical CP/M-68K Memory Layout 



1.4 Console Command Processor (CCP) 



The Console Command Processor, (CCP) provides the user 
interface to CP/M-68K. It uses the BDOS to read user commands and 
load programs, and provides several built-in user commands. It also 
provides parsing of command lines entered at the console. 
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1.5 Basic Disk Operating System (BDOS) 

The Basic Disk Operating System (BDOS) provides operating 
system services to applications programs and to the CCP. These 
include character I/O, disk file I/O (the BDOS disk I/O operations 
comprise the CP/M-68K file system), program loading, and others. 

1.6 Basic I/O System (BIOS) 

The Basic Input Output System (BIOS) is the interface between 
CP/M-68K and its hardware environment. All physical input and 
output is done by the BIOS. It includes all physical device 
drivers, tables defining disk characteristics, and other hardware 
specific functions and tables. The CCP and BDOS do not change for 
different hardware environments because all hardware dependencies 
have been concentrated in the BIOS. Each hardware configuration 
needs its own BIOS. Section 4 describes the BIOS functions in 
detail. Section 5 discusses how to write a custom BIOS. Sample 
BlOSes are presented in the appendixes. 

1.7 I/O Devices 

CP/M-68K recognizes two basic types of I/O devices: character 
devices and disk drives. Character devices are serial devices that 
handle one character at a time. Disk devices handle data in units 
of 128 bytes, called sectors, and provide a large number of sectors 
which can be accessed in random, nonsequential, order. In fact, 
real systems might have devices with characteristics different from 
these. It is the BIOS's responsibility to resolve differences 
between the logical device models and the actual physical devices. 

1.7.1 Character Devices 

Character devices are input output devices which accept or 
supply streams of ASCII characters to the computer. Typical 
character devices are consoles, printers, and modems. In CP/M-68K 
operations on character devices are done one character at a time. A 
character input device sends ASCII CTRL-Z (1AH) to indicate end-of- 
file. 



1.7.2 Character Devices 

Disk devices are used for file storage. They are organized 
into sectors and tracks. Each sector contains 128 bytes of data. 
(If sector sizes other than 128 bytes are used on the actual disk, 
then the BIOS must do a logical-to-physical mapping to simulate 128- 
byte sectors to the rest of the system.) All disk I/O in CP/M-68K is 
done in one-sector units. A track is a group of sectors. The 
number of sectors on a track is a constant depending on the 
particular device. (The characteristics of a disk device are 
specified in the Disk Parameter Block for that device. See 
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Section 5.) To locate a particular sector, the disk, track number, 
and sector number must all be specified. 

1.8 System Generation and Cold Start Operation 

Generating a CP/M-68K system is done by linking together the 
CCP, BDOS, and BIOS to create a file called CPM.SYS, which is the 
operating system. Section 2 discusses how to create CPM.SYS. 
CPM.SYS is brought into memory by a bootstrap loader which will 
typically reside on the first two tracks of a system disk. (The 
term system disk as used here simply means a disk with the file 
CPM.SYS and a bootstrap loader.) Creation of a bootstrap loader is 
discussed in Section 3". 

End of Section 1 



Section 2 
System Generation 



2.1 Overview 

This section describes how to build a custom version of CP/M- 
68K by combining your BIOS with the CCP and BDOS supplied by Digital 
Research to obtain a CP/M-68K operating system suitable for your 
specific hardware system. Section 5 describes how to create a BIOS. 

In this section, we assume that you have access to an already 
configured and executable CP/M-68K system. If you do not, you 
should first read Section 6, which discusses how you can make your 
first CP/M-68K system work. 

A CP/M-68K operating system is generated by using the linker, 
L068, to link together the system modules (CCP, BDOS, and BIOS). 
Then the RELOC utility is used to bind the system to an absolute 
memory location. The resulting file is the configured operating 
system. It is named CPM.SYS. 

2.2 Creating CPM.SYS 

The CCP and BDOS for CP/M-68K are distributed in a library 
file named CPMLIB. You must link your BIOS with CPMLIB using the 
following command: 

A>L068 -R -UCPM -0 CPM.REL CPMLIB BIOS.O 

where BIOS.O is the compiled or assembled BIOS. This creates 
CPM.REL, which is a relocatable version of your system. The cold 
boot loader, however, can load only an absolute version of the 
system, so you must now create CPM.SYS, an absolute version of your 
system. If you want your system to reside at the top of memory, 
first find the size of the system with the following command: 

A>SIZE68 CPM.REL 

This gives you the total size of the system in both decimal 
and hex byte counts. Subtract this number from the highest memory 
address in your system and add one to get the highest possible 
address at which CPM.REL can be relocated. Assuming that the result 
is aaaaaa, type this command: 

A>RBLOC -B aaaaaa CPM.REL CPM.SYS 

The result is the CPM.SYS file, relocated to load at memory 
address aaaaaa. If you want CPM.SYS to reside at some other memory 
address, such as immediately above the exception vector area, you 
can use RELOC to place the system at that address. 
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When you perform the relocation, verify that the resulting 
system does not overlap the TPA as defined in the BIOS. The 
boundaries of the system are determined by taking the relocation 
address of CPM.SYS as the base, and adding the size of the system 
(use SIZE68 on CPM.SYS) to get the upper bound. This address range 
must not overlap the TPA that the BIOS defines in the Memory Region 
Table. 

2.3 Relocating Utilities 

Once you have built CPM.SYS, it is advisable to relocate the 
operating system utilities for your .TPA using the RELOC utility. 
RELOC is described in the CP/M-68K Operating System Programmer's 
Guide. This results in the utilities being absolute, rather than 
relocatable, but they will occupy half the disk space and load into 
memory twice as fast in their new form. You should also keep the 
relocatable versions backed up in case you ever need to use them in 
a different TPA. 



End of Section 2 



Section 3 
Bootstrap Procedures 



3.1 Bootstrapping Overview 

Bootstrap loading is the process of bringing the CP/M-68K 
operating system into memory and passing control to it. Bootstrap 
loading is necessarily hardware dependent, and it is not possible to 
discuss all possible variations in this manual. However, the manual 
presents a model of bootstrapping that is applicable to most 
systems. 

The model of bootstrapping which we present assumes that the 
CP/M-68K operating system is to be loaded into memory from a disk in 
which the first few tracks (typically the first two) are reserved 
for the operating system and bootstrap routines, while the remainder 
of the disk contains the file structure, consisting of a directory 
and disk files. (The topic of disk organization and parameters is 
discussed in Section 5.) In our model, the CP/M-68K operating 
system resides in a disk file named CPM.SYS (described in Section 
2), and the system tracks contain a bootstrap loader program 
(CPMLDR.SYS) which knows how to read CPM.SYS into memory and 
transfer control to it. 

Most systems have a boot procedure similar to the following: 

1) When you press reset, or execute a boot command from a 
monitor ROM, the hardware loads one or more sectors 
beginning at track 0, sector 1, into memory at a 
predetermined address, and then jumps to that address. 

2) The code that came from track 0, sector 1, and is now 
executing, is typically a small bootstrap routine that 
loads the rest of the sectors on the system tracks 
(containing CPMLDR) into another predetermined address in 
memory, and then jumps to that address. Note that if your 
hardware is smart enough, steps 1 and 2 can be combined 
into one step. 

3) The code loaded in step 2, which is now executing, is the 
CP/M Cold Boot Loader, CPMLDR, which is an abbreviated 
version of CP/M-68K itself. CPMLDR now finds the file 
CPM.SYS, loads it, and jumps to it. A copy of CPM.SYS is 
now in memory, executing. This completes the bootstrapping 
process. 

In order to create a CP/M-68K diskette that can be booted, you 
need to know how to create CPM.SYS (see Section 2.2), how to create 
the Cold Boot Loader, CPMLDR, and how to put CPMLDR onto your system 
tracks. You must also understand your hardware enough to be able to 
design a method for bringing CPMLDR into memory and executing it. 
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3.2 Creating the Cold Boot Loader 

CPMLDR is a miniature version of CP/M-68K. It contains 
stripped versions of the BDOS and BIOS, with only those functions 
which are needed to open the CPM.SYS file and read it into memory. 
CPMLDR will exist in at least two forms; one form is the information 
in the system tracks, the other is a file named CPMLDR. SYS which is 
created by the linker. The term CPMLDR is used to refer to either 
of these forms, but CPMLDR. SYS only refers to the file. 

CPMLDR. SYS is generated using a procedure similar to that used 
in generating CPM.SYS. That is, a loader BIOS is linked with a 
loader system library, named LDRLIB, to produce CPMLDR. SYS. 
Additional modules may be linked in as required by your hardware. 
The resulting file is then loaded onto the system tracks using a 
utility program named PUTBOOT. 

3.2.1 Writing a Loader BIOS 

The loader BIOS is very similar to your ordinary BIOS; it just 
has fewer functions, and the entry convention is slightly different. 
The differences are itemized below. 



1) Only one disk needs to be supported. The loader system 
selects only drive A. If you want to boot from a drive 
other than A, your loader BIOS should be written to select 
that other drive when it receives a request to select drive 
A. 

2) The loader BIOS is not called through a trap; the loader 
BDOS calls an entry point named _bios instead. The 
parameters are still passed in registers, just as in the 
normal BIOS. Thus, your Function does not need to 
initialize a trap, the code that in a normal BIOS would be 
the Trap 3 handler should have the label _bios, and you 
exit from your loader BIOS with an RTS instruction instead 
of an RTE. 

3) Only the following BIOS functions need to be implemented: 

0- (Init) Called just once, should initialize hardware 

as necessary, no return value necessary. Note that 
Function is called via _bios with the function number 
equal to 0. You do not need a separate _init entry point. 

4 (Conout) Used to print error messages during boot. If 
you do not want error messages, this function should just 
be an rts. 

9 (Seldsk) Called just once, to select drive A. 

10 (Settrk) 



10 
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11 (Setsec) 

12 (Setdma) 

13 (Read) 

16 (Sectran) 

18 (Get MRT) Not used now, but may be used in future 
releases. 

22 (Set exception) 

4) You do not need to include an allocation vector or a check 
vector, and the Disk Parameter Header values that point to 
these can be anything. However, you still need a Disk 
Parameter Header, Disk Parameter Block, and directory 
buffer. 



It is possible to use the same source code for both your normal 
BIOS and your loader BIOS if you use conditional compilation or 
assembly to distinguish the two. We have done this in our example 
BIOS for the EXORmacs™ 



3.2.2 Building CPMLDR.SYS 

Once you have written and compiled (or assembled) a loader 
BIOS, you can build CPMLDR.SYS in a manner very similar to building 
CPM.SYS. There is one additional complication here: the result of 
this step is placed on the system tracks. So, if you need a small 
prebooter to bring in the bulk of CPMLDR, the prebooter must also be 
included in the link you are about to do. The details of what must 
be done are hardware dependent, but the following example should 
help to clarify the concepts involved. 

Suppose that your hardware reads track 0, sector 1, into memory 
at location 400H when reset is pressed, then jump to 4 00H. Then 
your boot disk must have a small program in that sector that can 
load the rest of the system tracks into memory and execute the code 
that they contain. Suppose that you have written such a program, 
assembled it, and the assembler output is in BOOT.O. Also assume 
that your loader BIOS object code is in the file LDRBIOS.O. Then 
the following command links together the code that must go on the 
system tracks. 

A>lo68 -s -T400 -uldr -o cpmldr.sys boot.o ldrlib ldrbios.o 

Once you have created CPMLDR.SYS in this way, you can use the 
PUTBOOT utility to place it on the system tracks. PUTBOOT is 
described in Section 8. The command to place CPMLDR on the system 
tracks of drive A is: 

A>putboot cpmldr.sys a 
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PUTBOOT reads the file CPMLDR.SYS, strips off the 28- byte 
command file header, and puts the result on the specified drive. 
You can now boot from this disk, assuming that CPM.SYS is on the 
disk. 



End of Section 3 
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Section 4 
BIOS Functions 



4.1 Introduction 

All CP/M-68K hardware dependencies are concentrated in 
subroutines that are collectively referred to as the Basic I/O 
System (BIOS). A CP/M-68K system implementor can tailor CP/M-68K to 
fit nearly any 68000 operating environment. This section describes 
each BIOS function: its calling conventions, parameters, and the 
actions it must perform. The discussion of Disk Definition Tables 
is treated separately in Section 5. 

When the BDOS calls a BIOS function, it places the function 
number in register DO.W, and function parameters in registers Dl and 
D2. It then executes a TRAP 3 instruction. DO.W is always needed 
to specify the function, but each function has its own requirements 
for other parameters, which are described in the section describing 
the particular function. The BIOS returns results, if any, in 
register DO. The size of the result depends on the particular 
function. 

Note: the BIOS does not need to preserve the contents of registers. 
That is, any register contents which were valid on entry to the BIOS 
may be destroyed by the BIOS on exit. The BDOS does not depend on 
the BIOS to preserve the contents of data or address registers. Of 
course, if the BIOS uses interrupts to service I/O, the interrupt 
handlers will need to preserve registers. 

Usually, user applications do not need to make direct use of 
BIOS functions. However, when access to the BIOS is required by 
user software, it should use the BDOS Direct BIOS Function, Call 50, 
instead of calling the BIOS with a TRAP 3 instruction. This rule 
ensures that applications remain compatible with future systems. 

The Disk Parameter Header (DPH) and Disk Parameter Block (DPB) 
formats have changed slightly from previous CP/M versions to 
accommodate the 68000' s 32-bit addresses. The formats are described 
in Section 5. 
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Table 4-1. BIOS Register Usage 



Entry Parameters: 



DO.W = function code 
Dl.x = first parameter 
D2.x = second parameter 



Return Values: 

DO .B = byte values (8 bits) 
DO.W = word values (16 bits) 
DO.L = longword values (32 bits) 



The decimal BIOS function numbers 
correspond to are listed in Table 4-2. 



and the functions they 



Table 4-2. BIOS Functions 



Number 


Function 





Initialization (called for cold boot) 


1 


Warm Boot (called for warm start) 


2 


Console Status (check for console 




character ready) 


3 


Read Console Character In 


4 


Write Console Character Out 


5 


List (write listing character out) 


6 


Auxiliary Output (write character to 




auxiliary output device) 


7 


Auxiliary Input (read from auxiliary 




input) 


8 


Home (move to track 00) 


9 


Select Disk Drive 


10 


Set Track Number 


11 


Set Sector Number 


12 


Set DMA Address 


13 


Read Selected Sector 


14 


Write Selected Sector 


15 


Return List Status 


16 


Sector Translate 


18 


Get Memory Region Table Address 


19 


Get I/O Mapping Byte 


20 


Set I/O Mapping Byte 


21 


Flush Buffers 


22 


Set Exception Handler Address 
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FUNCTION 0; 



INITIALIZATION 



Entry Parameters: 

Register DO.W: 00H 



Returned Value: 

Register DO.W: User/Disk Numbers 



This routine is entered on cold boot and must initialize the 
BIOS. Function is unique, in that it is not entered with a TRAP 3 
instruction. Instead, the BIOS has a global label, _init, which is 
the entry to this routine. On cold boot, Function is called by a 
jsr _init. When initialization is done, exit is through an rts 
instruction. Function is responsible for initializing hardware if 
necessary, initializing BIOS internal variables (such as IOBYTE) as 
needed, setting up register DO as described below, setting the Trap 
3 vector to point to the main BIOS entry point, and then exiting 
with an rts. 

Function returns a longword value. The CCP uses this value 
to set the initial user number and the initial default disk drive. 
The least significant byte of DO is the disk number (0 for drive A, 
1 for drive B, and so on). The next most significant byte is the 
user number. The high-order bytes should be zero. 

The entry point to this function must be named _init and must 
be declared global. This function is called only once from the 
system at system initialization. 

Following is an example of skeletal code: 



globl 



in it 



;bios in it entry point 



in it: 

do any initialization here 
move.l # traphndl,$8c 

clr.l dO 

rts 



;set trap 3 handler 
; log in drive A, user 
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Function 1: Warm Boot 



FUNCTION 1: 


WARM 


BOOT 


Entry Parameters: 
Register DO.W: 


01H 


Returned 


Value: 


None 



This function is called whenever a program terminates. Some 
reinitialization of the hardware or software might occur. When this 
function completes, it jumps directly to the entry point of the CCP, 
named _ccp. Note that _ccp must be declared as a global. 

Following is an example of skeletal code for this BIOS 
function: 



.globl 



ccp 



wboot : 

* do any reinitialization here if necessary 
jmp ccp 
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Function 2: Console Status 



FUNCTION 2: 


CONSOLE STATUS 


Entry Parameters: 
Register DO.W: 


2H 


Returned Value: 
Register DO.W: 
Register DO.W: 


OOFFH if ready 
0000H if not ready 



This function returns the status of the currently assigned 
console device. It returns OOFFH in register DO when a character is 
ready to be read, or 0000H in register DO when no console characters 
are ready. 
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Function 3: Read Console Character 



FUNCTION 3: READ CONSOLE CHARACTER 



Entry Parameters: 

Register DO.W: 03H 



Returned Value: 

Register DO.W: Character 



This function reads the next console character into register 
DO.W. If no console character is ready, it waits until a character 
is typed before returning. 
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Function 4: Write Console Character 



FUNCTION 4: WRITE CONSOLE CHARACTER 



Entry Parameters: 

Register DO.W: 04H 
Register Dl.W: Character 



Returned Value: None 



This function sends the character from register Dl to the 
console output device. The character is in ASCII. You might want 
to include a delay or filler characters for a line-feed or carriage 
return, if your console device requires some time interval at the 
end of the line (such as a TI Silent 700 Terminal® ). You can 
also filter out control characters which have undesirable effects on 
the console device. 
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Function 5: List Character Output 



FUNCTION 5: LIST CHARACTER OUTPUT 



Entry Parameters: 

Register DO.W: 05H 
Register Dl.W: Character 



Returned 



Value: None 



This function sends an ASCII character from register Dl to the 
currently assigned listing device. If your list device requires 
some communication protocol, it must be handled here. 
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Function 6: Auxiliary Output 



FUNCTION 6: AUXILIARY OUTPUT 



Entry Parameters: 

Register DO.W: 06H 
Register Dl.W: Character 



Returned Value: 

Register DO.W: Character 



This function sends an ASCII character from register Dl to the 
currently assigned auxiliary output device. 
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Function 7: Auxiliary Input 



FUNCTION 7: AUXILIARY INPUT 



Entry Parameters: 

Register DO.W: 07H 



Returned Value: 

Register DO.W: Character 



This function reads the next character from the currently 
assigned auxiliary input device into register DO. It reports an 
end-of-file condition by returning an ASCII CTRL-Z (1AH) . 
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Function 8: Home 



FUNCTION 8: HOME 



Entry Parameters: 

Register DO.W: 08H 



Returned Value: None 



This function returns the disk head of the currently selected 
disk to the track 00 position. If your controller does not have a 
special feature for finding track 00, you can translate the call to 
a SETTRK function with a parameter of 0. 
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Function 9: 



Select Disk Drive 



FUNCTION 9: SELECT DISK DRIVE 



Entry Parameters: 

Register DO.W: 09H 
Register Dl.B: Disk Drive 
Register D2.B: Logged in Flag 



Returned Value: 

Register DO.L: Address of Selected 
Drive's DPH 



This function selects the disk drive specified in register Dl 
for further operations. Register Dl contains for drive A, 1 for 
drive B, up to 15 for drive P. 

On each disk select, this function returns the address of the 
selected drive's Disk Parameter Header in register DO.L. See 
Section 5 for a discussion of the Disk Parameter Header. 

If there is an attempt to select a nonexistent drive, this 
function returns 00000000H in register DO.L as an error indicator. 
Although the function must return the header address on each call, 
it may be advisable to postpone the actual physical disk select 
operation until an I/O function (seek, read, or write) is performed. 
Disk select operations can occur without a subsequent disk 
operation. Thus, doing a physical select each time this function is 
called may be wasteful of time. 

On entry to the Select Disk Drive function, if the least 
significant bit in register D2 is zero, the disk is not currently 
logged in. If the disk drive is capable of handling varying media 
(such as single- and double-sided disks, single- and double-density, 
and so on) , the BIOS should check the type of media currently 
installed and set up the Disk Parameter Block accordingly at this 
time. 
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Function 10: Set Track Number 



FUNCTION 10: SET TRACK NUMBER 



Entry Parameters: 

Register DO.W: OAH 

Register Dl.W: Disk track number 



Returned Value: None 



This function specifies in register DO.W the disk track number 
for use in subsequent disk accesses. The track number remains valid 
until either another Function 10 or a Function 8 (Home) is 
performed. 

You can choose to physically seek to the selected track at this 
time, or delay the physical seek until the next read or write 
actually occurs. 

The track number can range from to the maximum track number 
supported by the physical drive. However, the maximum track number 
is limited to 65535 by the fact that it is being passed as a 16-bit 
quantity. Standard floppy disks have tracks numbered from to 76. 
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Function 11: Set Sector Number 



FUNCTION 11: SET SECTOR NUMBER 



Entry Parameters: 

Register DO.W: OBH 

Register Dl.W: Sector Number 



Returned Value: None 



This function specifies in register Dl.W the sector number for 
subsequent disk accesses. This number remains in effect until 
either another Function 11 is performed. 

The function selects actual (unskewed) sector numbers. If 
skewing is appropriate, it will have previously been done by a call 
to Function 16. You can send this information to the controller at 
this point or delay sector selection until a read or write operation 
occurs. 
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Function 12: Set DMA Address 



FUNCTION 12: SET 


DMA ADDRESS 


Entry Parameters: 
Register DO.W: 
Register DLL: 


OCH 

DMA Address 


Returned Value: 


None 



This function contains the DMA (disk memory access) address in 
register Dl for subsequent read or write operations. Note that the 
controller need not actually support DMA (direct memory access). 
The BIOS will use the 128-byte area starting at the selected DMA 
address for the memory buffer during the following read or write 
operations. This function can be called with either an even or an 
odd address for a DMA buffer. 



27 



CP/M-68K System Guide 



Function 13: Read Sector 



FUNCTION 13: READ SECTOR 



Entry Parameters: 

Register DO.W: ODH 



Returned Value: 

Register DO.W: if no error 
Register DO.W: 1 if physical error 



After the drive has been selected, the track has been set, the 
sector has been set, and the DMA address has been specified, the 
read function uses these parameters to read one sector and returns 
the error code in register DO. 

Currently, CP/M-68K responds only to a zero or nonzero return 
code value. Thus, if the value in register DO is zero, CP/M-68K 
assumes that the disk operation completed properly. If an error 
occurs however, the BIOS should attempt at least ten retries to see 
if the error is recoverable. 
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Function 14: 



Write Sector 



FUNCTION 14: WRITE SECTOR 



Entry Parameters: 

Register DO.W: OEH 

Register Dl.W: 0=normal write 

l=write to a directory 

sector 
2=write to first sector 
of new block 



Returned Value: 

Register DO.W: 0=no error 

1= physical error 



This function is used to write 128 bytes of data from the 
currently selected DMA buffer to the currently selected sector, 
track, and disk. The value in register Dl.W indicates whether the 
write is an ordinary write operation or whether the there are 
special considerations. 

If register D1.W=0, this is an ordinary write operation. If 
Dl.W=l, this is a write to a directory sector, and the write should 
be physically completed immediately. If Dl.W=2, this is a write to 
the first sector of a newly allocated block of the disk. The 
significance of this value is discussed in Section 5 under Disk 
Buffering. 
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Function 15: Return List Status 



FUNCTION 15: RETURN LIST STATUS 



Entry Parameters: 

Register DO.W: OFH 



Returned Value: 

Register DO: 00FFH=device ready 
Register DO: 0000H=device not ready 



This function returns the status of the list device. Register 
DO contains either 0000H when the list device, is not ready to accept 
a character or OOFFH when a character can be sent to the list 
device. 
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Function 16: Sector Translate 



FUNCTION 16: SECTOR TRANSLATE 



Entry Parameters: 

Register DO.W: 10H 

Register Dl.W: Logical Sector Number 
Register D2.L: Address of Translate 
Table 



Returned Value: 

Register DO.W: Physical Sector Number 



This function performs logical- to-physical sector translation, 
as discussed in Section 5.2.2. The Sector Translate function 
receives a logical sector number from register Dl.W. The logical 
sector number can range from to the number of sectors per track-1. 
Sector Translate also receives the address of the translate table in 
register D2.L. The logical sector number is used as an index into 
the translate table. The resulting physical sector number is 
returned in DO.W. 

If register D2.L = 00000000H, implying that there is no 
translate table, register Dl is copied to register DO before 
returning. Note that other algorithms are possible; in particular, 
is is common to increment the logical sector number in order to 
convert the logical range of to n-1 into the physical range of 1 
to n. Sector Translate is always called by the BDOS, whether the 
translate table address in the Disk Parameter Header is zero or 
nonzero. 
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Function 18: Get Address of MRT 



FUNCTION 18: 



GET ADDRESS OF MEMORY 
REGION TABLE 



Entry Parameters: 

Register DO.W: 12H 



Returned Value: 

Register DO.L: Memory Region 
Table Address 



This function returns the address of the Memory Region Table 
(MRT) in register DO. For compatibility with other CP/M systems, 
CP/M-68K maintains a Memory Region Table. However, it contains only 
one region, the Transient Program Area (TPA). The format of the MRT 
is shown below: 



Entry Count = 1 16 bits 



Base address of first region 



Length of first region 



32 bits 
32 bits 



Figure 4-1. Memory Region Table Format 



The memory region table must begin on an even address, and must 
be implemented. 
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Function 19: Get I/O Byte 



FUNCTION 19: 


GET I/O BYTE 


Entry Parameters: 
Register DO.W: 


13H 


Returned Value: 
Register DO.W: 


I/O Byte Current 
Value 



This function returns the current value of the logical to 
physical input/output device byte (I/O byte) in register DO.W. This 
8-bit value associates physical devices with CP/M-68K's four logical 
devices as noted below. Note that even though this is a byte value, 
we are using word references. The upper byte should be zero. 

Peripheral devices other than disks are seen by CP/M-68K as 
logical devices, and are assigned to physical devices within the 
BIOS. Device characteristics are defined in Table 4-3 below. 



Table 


4-3. CP/M-68K Logical Device Characteristics 


Device 


Name 


Characteristics 


CONSOLE 




The interactive console that you use 
to communicate with the system is 
accessed through functions 2, 3 and 
4. Typically, the console is a CRT 
or other terminal device. 


LIST 




The listing device is a hard-copy 
device, usually a printer. 


AUXILIARY 


OUTPUT 


An optional serial output device. 


AUXILIARY 


INPUT 


An optional serial input device. 



Note that a single peripheral can be assigned as the LIST, 
AUXILIARY INPUT, and AUXILIARY OUTPUT device simultaneously. If no 
peripheral device is assigned as the LIST, AUXILIARY INPUT, or 
AUXILIARY OUTPUT device, your BIOS should give an appropriate error 
message so that the system does not hang if the device is accessed 
by PIP or some other transient program. Alternatively, the 
AUXILIARY OUTPUT and LIST functions can simply do nothing except 
return to the caller, and the AUXILIARY INPUT function can return 
with a 1AH (CTRL-Z) in register DO.W to indicate immediate end-of- 
file. 
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Function 19: Get I/O Byte 



The I/O byte is split into four 2-bit fields called CONSOLE, 
AUXILIARY INPUT, AUXILIARY OUTPUT, and LIST, as shown in Figure 4-2. 



most significant 



least significant 



I/O Byte 
bits 



LIST 



AUXILIARY 
OUTPUT 



AUXILIARY 
INPUT 



CONSOLE 



7,6 5,4 3,2 1,0 



Figure 4-3. I/O Byte 



The value in each field can be in the range 0-3, defining the 
assigned source or destination of each logical device. The values 
which can be assigned to each field are given in Table 4-4. 





Table 4-4. I/O Byte Fijeld Definitions 


CONSOLE field (bits 1,0) 


Bit 


Definition 



1 
2 

3 


console is assigned to the console printer (TTY:) 

console is assigned to the CRT device (CRT:) 

batch mode: use the AUXILIARY INPUT as the CONSOLE 

input, and the LIST device as the CONSOLE output 

(BAT:) 

user defined console device (UC1:) 


AUXILIARY INPUT field (bits 3,2) 


Bit 


Definition 



1 

2 
3 


AUXILIARY INPUT is the Teletype device (TTY:) 
AUXILIARY INPUT is the high-speed reader device 
(PTR:) 

user defined reader #1 (UR1:) 
user defined reader #2 (UR2:) 
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Function 19: Get I/O Byte 







Table 4-4. (continued) 




AUXILIARY OUTPUT field (bits 5,4) 


Bit 


Definition 




1 
2 
3 


AUXILIARY OUTPUT is the Teletype device (TTY:) 
AUXILIARY OUTPUT is the high-speed punch device 
user defined punch #1 (UP1: ) 
user defined punch #2 (UP2:) 


(PTP:) 


LIST field (bits 7,6) 


Bit 


Definition 



1 
2 
3 


LIST 
LIST 
LIST 
user 


is the Teletype device (TTY:) 
is the CRT device (CRT:) 
is the line printer device (LPT:) 
defined list device (UL1:) 





Note that the implementation of the I/O byte is optional, and 
affects only the organization of your BIOS. No CP/M-68K utilities 
use the I/O byte except for PIP, which allows access to the physical 
devices, and STAT, which allows logical-physical assignments to be 
made and displayed. It is a good idea to first implement and test 
your BIOS without the IOBYTE functions, then add the I/O byte 
function. 
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Function 20: Set I/O Byte 



FUNCTION 20: SET I/O BYTE 



Entry Parameters: 

Register DO.W: 14H 
Register Dl.W: Desired 



Returned Value: None 



This function uses the value in register Dl to set the value of 
the I/O byte that is stored in the BIOS. See Table 4-4 for the I/O 
byte field definitions. Note that even though this is a byte value, 
we are using word references. The upper byte should be zero. 
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Function 21: Flush Buffers 



FUNCTION 21: FLUSH BUFFERS 



Entry Parameters: 

Register DO.W: 15H 



Returned Value: 

Register DO.W: 0000H=successful write 
Register DO.W: FFFFH=unsuccessful write 



This function forces the contents of any disk buffers that have 
been modified to be written. That is, after this function has been 
performed, all disk writes have been physically completed. After 
the buffers are written, this function returns a zero in register 
DO.W. However, if the buffers cannot be written or an error occurs, 
the function returns a value of FFFFH in register DO.W. 
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Function 22: Set Exception Address 



FUNCTION 22: SET EXCEPTION HANDLER ADDRESS 



Entry Parameters: 

Register DO.W: 16H 

Register Dl.W: Exception Vector Number 

Register D2.L: Exception Vector Address 



Returned Value: 

Register DO.L: Previous Vector Contents 



This function sets the exception vector indicated in register 
Dl.W to the value specified in register D2.L. The previous vector 
value is returned in register DO.L. Unlike the BDOS Set Exception 
Vector Function (61), this BIOS function sets any exception vector. 
Note that register Dl.W contains the exception vector number. Thus, 
to set exception #2, bus error, this register contains a 2, and the 
vector value goes to memory locations 8H to OBH . 



End of Section 4 
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Section 5 
Creating a BIOS 



5-1 Overview 

The BIOS provides a standard interface to the physical 
input/output devices in your system. The BIOS interface is defined 
by the functions described in Section 4. Those functions, taken 
together, constitute a model of the hardware environment. Each BIOS 
is responsible for mapping that model onto the real hardware. 

In addition, the BIOS contains disk definition tables which 
define the characteristics of the disk devices which are present, 
and provides some storage for use by the BDOS in maintaining disk 
directory information. 

Section 4 describes the functions which must be performed by 
the BIOS, and the external interface to those functions. This 
Section contains additional information describing the structure and 
significance of the disk definition tables and information about 
sector blocking and deblocking. Careful choices of disk parameters 
and disk buffering methods are necessary if you are to achieve the 
best possible performance from CP/M-68K. Therefore, this section 
should be read thoroughly before writing a custom BIOS. 

CP/M-68K, as distributed by Digital Research, is configured to 
run on the Motorola EXORmacs development system with Universal Disk 
Controller. The sample BIOS in Appendix D is the BIOS used in the 
distributed system, and is written in C language. A sample BIOS for 
an Empirical Research Group (ERG) 68000 based microcomputer with 
Tarbell floppy disk controller is also included in Appendix B, and 
is written in assembly language. These examples should assist the 
reader in understanding how to construct his own BIOS. 

5.2 Disk Definition Tables 

As in other CP/M systems, CP/M-68K uses a set of tables to 
define disk device characteristics. This section describes each of 
these tables and discusses choices of certain parameters. 
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5.2 Disk Definition Tables 



5.2.1 Disk Parameter Header 

Each disk drive has an associated 26-byte Disk Parameter Header 
(DPH) which both contains information about the disk drive and 
provides a scratchpad area for certain BDOS operations. Each drive 
must have its own unique DPH. The format of a Disk Parameter Header 
is shown in Figure 5-1. 



XLT 


0000 


0000 


0000 


DIRBUF 


DPB 


CSV 


ALV 



32b 16b 16b 16b 32b 32b 32b 
Figure 5-1. Disk Parameter Header 



32b 



Each element of the DPH is either a word (16-bit) or longword 
(32-bit) value. The meanings of the Disk Parameter Header (DPH) 
elements are given in Table 5-1. 



Table 5-1. Disk Parameter Header Elements 



Element 



Description 



XLT Address of the logical-to-physical sector 
translation table, if used for this particular 
drive, or the value if there is no translation 
table for this drive (i.e, the physical and 
logical sector numbers are the same). Disk 
drives with identical sector translation may 
share the same translate table. The sector 
translation table is described in Section 5.2.2. 

0000 Three scratchpad words for use within the BDOS. 

DIRBUF Address of a 128-byte scratchpad area for 
directory operations within BDOS. All DPHs 
address the same scratchpad area. 

DPB Address of a disk parameter block for this drive. 
Drives with identical disk characteristics may 
address the same disk parameter block. 
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5.2 Disk Definition Tables 



Table 5-1. (continued) 



Element 



Description 



CSV Address of a checksum vector. The BDOS uses this 

area to maintain a vector of directory checksums 
for the disk. These checksums are used in 
detecting when the disk in a drive has been 
changed. If the disk is not removable, then it 
is not necessary to have a checksum vector. Each 
DPH must point to a unique checksum vector. The 
checksum vector should contain 1 byte for every 
four directory entries (or 128 bytes of 
directory). In other words: length (CSV) = 
(DRM + 1) / 4. (DRM is discussed in Section 

5.2.3.) 

ALV Address of a scratchpad area used by the BDOS to 

keep disk storage allocation information. The 
area must be different for each DPH. There must 
be 1 bit for each allocation block on the drive, 
requiring the following: length (ALV) = (DSM/8) + 
1. (DSM is discussed below.) 



5.2.2 Sector Translate Table 

Sector translation in CP/M-68K is a method of logically 
renumbering the sectors on each disk track to improve disk I/O 
performance. A frequent situation is that a program needs to access 
disk sectors sequentially. However, in reading sectors 
sequentially, most programs lose a full disk revolution between 
sectors because there is not enough time between adjacent sectors to 
begin a new disk operation. To alleviate this problem, the 
traditional CP/M solution is to create a logical sector numbering 
scheme in which logically sequential sectors are physically 
separated. Thus, between two logically contiguous sectors, there is 
a several sector rotational delay. The sector translate table 
defines the logical-to-physical mapping in use for a particular 
drive, if a mapping is used. 

Sector translate tables are used only within the BIOS. Thus 
the table may have any convenient format. (Although the BDOS is 
aware of the sector translate table, its only interaction with the 
table is to get the address of the sector translate table from the 
DPH and to pass that address to the Sector Translate Function of the 
BIOS.) The most common form for a sector translate table is an n- 
byte (or n-word) array of physical sector numbers, where n is the 
number of sectors per disk track. Indexing into the table with the 
logical sector number yields the corresponding physical sector 
number. 
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5.2 Disk Definition Tables 



Although you may choose any convenient logical- to-physical 
mapping, there is a nearly universal mapping used in the CP/M 
community for single-sided, single -density, 8-inch diskettes. That 
mapping is shown in Figure 5-2. Because your choice of mapping 
affects diskette compatibility between different systems, the 
mapping of Figure 5-2 is strongly recommended. 



Logical Sector 
Physical Sector 


0123456789 10 11 12 
1 7 13 19 25 5 11 17 23 3 9 15 21 


Logical Sector 
Physical Sector 


13 14 15 16 17 18 19 20 21 22 23 24 25 
2 8 14 20 26 6 12 18 24 4 10 16 22 



Figure 5-2. Sample Sector Translate Table 



5.2.3 Disk Parameter Block 

A Disk Parameter Block (DPB) defines several characteristics 
associated with a particular disk drive. Among them are the size of 
the drive, the number of sectors per track, the amount of directory 
space, and others. 

A Disk Parameter Block can be used in one or more DPH's if the 
disks are identical in definition. A discussion of the fields of 
the DPB follows the format description. The format of the DPB is 
shown in Figure 5-3. 



SPT 


BSH 


BLM 


EXM 





DSM 


DRM 


Reserved 


CKS 


OFF 



16b 8b 8b 8b 8b 16b 16b 16b 

Figure 5-3. Disk Parameter Block 



16b 16 b 



Each field is a word (16 bit) or a byte (8 bit) value. The 
description of each field is given in Table 5-2. 



Table 5-2. Disk Parameter Block Fields 



Field 



Definition 



SPT Number of 128-byte logical sectors per track. 

BSH The block shift factor, determined by the data 

block allocation size, as shown in Table 5-3. 
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5.2 Disk Definition Tables 



Table 5-2. (continued) 



Field 


Definition 


BLM 


The block mask which is determined by the data 




block allocation size, as shown in Table 5-3. 


EXM 


The extent mask, determined by the data block 




allocation size and the number of disk blocks, as 




shown in Table 5-4. 





Reserved byte. 


DSM 


Determines the total storage capacity of the disk 




drive and is the number of the last block, 




counting from 0. That is, the disk contains 




DSM+1 blocks. 


DRM 


Determines the total number of directory entries 




which can be stored on this drive. DRM is the 




number of the last directory entry, counting from 




0. That is, the disk contains DRM+1 directory 




entries. Each directory entry requires 32 bytes, 




and for maximum efficiency, the value of DRM 




should be chosen so that the directory entries 




exactly fill an integral number of allocation 




units. 


CKS 


The size of the directory check vector, which is 




zero if the disk is permanently mounted, or 




length (CSV) = (DRM) / 4 + 1 for removable media. 


OFF 


The number of reserved tracks at the beginning of 




a logical disk. This is the number of the track 




on which the directory begins. 



To choose appropriate values for the Disk Parameter Block 
elements, you must understand how disk space is organized in CP/M- 
68K. A CP/M-68K disk has two major areas: the boot or system 
tracks, and the file system tracks. The boot tracks are usually 
used to hold a machine-dependent bootstrap loader for the operating 
system. They consist of tracks to OFF-1 . Zero is a legal value 
for OFF, and in that case, there are no boot tracks. The usual 
value of OFF for 8-inch floppy disks is two. 

The tracks after the boot tracks (beginning with track number 
OFF) are used for the disk directory and disk files. Disk space in 
this area is grouped into units called allocation units or blocks. 
The block size for a particular disk is a constant, called BLS. BLS 
may take on any one of these values: 1024, 2048, 4096, 819 2, or 
16384 bytes. No other values for BLS are allowed. (Note that BLS 
does not appear explicitly in any BIOS table. However, it 
determines the values of a number of other parameters. ) The DSM 
field in the Disk Parameter Block is one less than the number of 
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5.2 Disk Definition Tables 



blocks on the disk. Space is allocated to a file or to the 
directory in whole blocks. No fraction of a block can be allocated, 
block size 

The choice of BLS is very important, because it effects the 
efficiency of disk space utilization, and because for any disk size 
there is a minimum value of BLS that allows the entire disk to be 
used. Each block on the disk has a block number ranging from to 
DSM. The largest block number allowed is 32767. Therefore, the 
largest number of bytes that can be addressed in the file system 
space is 32768 * BLS. Because the largest allowable value for BLS 
is 16384, the biggest disk that can be accessed by CP/M-68K is 
16384*32768 = 512 Mbytes. 

Each directory entry may contain either 8 block numbers (if DSM 
>= 256) or 16 block numbers (if DSM < 256). Each file needs enough 
directory entries to hold the block numbers of all blocks allocated 
to the file. Thus a large value for BLS implies that fewer 
directory entries are needed. Since fewer directory entries are 
used, the directory search time is decreased. 

The disadvantage of a large value for BLS is that since files 
are allocated BLS bytes at a time, there is potentially a large 
unused portion of a block at the end of the file. If there are many 
small files on a disk, the waste can be very significant. 

The BSH and BLM parameters in the DPB are functions of BLS. 
Once you have chosen BLS, you should use Table 5-3 to determine BSH 
and BLM. The EXM parameter of the DPB is a function of BLS and DSM. 
You should use Table 5-4 to find the value of EXM for your disk. 



Table 5-3. 



BSH and BIM Values 



BLS 


BSH 


BLM 


1024 


3 


7 


2048 


4 


15 


4096 


5 


31 


8192 


6 


63 


16384 


7 


127 
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5.2 Disk Definition Tables 



Table 5-4. EXM Values 



BLS 


DSM < = 


255 


DSM 


> 255 


1024 









N/A 


2048 


1 









4096 


3 






1 


8192 


7 






3 


16384 


15 






7 



The DRM entry in the DPB is one less than the total number of 
directory entries. DRM should be chosen large enough so that you do 
not run out of directory entries before running out of disk space. 
It is not possible to give an exact rule for determining DRM, since 
the number of directory entries needed will depend on the number and 
sizes of the files present on the disk. 

The CKS entry in the DPB is the number of bytes in the CSV 
(checksum vector) which was pointed to by the DPH. If the disk is 
not removable, a checksum vector is not needed, and this value may 
be zero. 



5.3 Disk Blocking 

When the BDOS does a disk read or write operation using the 
BIOS, the unit of information read or written is a 128-byte sector. 
This may or may not correspond to the actual physical sector size of 
the disk. If not, the BIOS must implement a method of representing 
the 128-byte sectors used by CP/M-68K on the actual device. Usually 
if the physical sectors are not 128 bytes long, they will be some 
multiple of 128 bytes. Thus, one physical sector can hold some 
integer number of 128-byte CP/M sectors. In this case, any disk I/O 
will actually consist of transferring several CP/M sectors at once. 

It might also be desirable to do disk I/O in units of several 
128-byte sectors in order to increase disk throughput by decreasing 
rotational latency. (Rotational latency is the average time it 
takes for the desired position on a disk to rotate around to the 
read/write head. Generally this averages 1/2 disk revolution per 
transfer.) Since a great deal of disk I/O is sequential, rotational 
latency can be greatly reduced by reading several sectors at a time, 
and saving them for future use. 

In both the cases above, the point of interest is that physical 
I/O occurs in units larger than the expected sector size of 128 
bytes. Some of the problems in doing disk I/O in this manner are 
discussed below. 
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5.3.1 A Simple Approach 

This section presents a simple approach to handling a physical 
sector size larger than the logical sector size. The method 
discussed in this section is not recommended for use in a real BIOS. 
Rather, it is given as a starting point for refinements discussed in 
the following sections. Its simplicity also makes it a logical 
choice for a first BIOS on new hardware. However, the disk 
throughput that you can achieve with this method is poor, and the 
refinements discussed later give dramatic improvements. 

Probably the easiest method for handling a physical sector size 
which is a multiple of 128 bytes is to have a single buffer the size 
of the physical sector internal to the BIOS. Then, when a disk read 
is to be done, the physical sector containing the desired 128-byte 
logical sector is read into the buffer, and the appropriate 128 
bytes are copied to the DMA address. Writing is a little more 
complicated. You only want to put data into a 128-byte portion of 
the physical sector, but you can only write a whole physical sector. 
Therefore, you must first read the physical sector into the BIOS' s 
buffer; copy the 128 bytes of output data into the proper 128-byte 
piece of the physical sector in the buffer; and finally write the 
entire physical sector back to disk. 

Note: this operation involves two rotational latency delays in 
addition to the time needed to copy the 128 bytes of data. In fact, 
the second rotational wait is probably nearly a full disk 
revolution, since the copying is usually much faster than a disk 
revolution. 



5.3.2 Some Refinements 

There are some easy things that can be done to the algorithm of 
Section 5.2.1 to improve its performance. The first is based on the 
fact that disk accesses are usually done sequentially. Thus, if 
data from a certain physical sector is needed, it is likely that 
another piece of that sector will be needed on the next disk 
operation. To take advantage of this fact, the BIOS can keep 
information with its physical sector buffer as to which disk, track, 
and physical sector (if any) is represented in the buffer. Then, 
when reading, the BIOS need only do physical disk reads when the 
information needed is not in the buffer. 

On writes, the BIOS still needs to preread the physical sector 
for the same reasons discussed in Section 5.2.1, but once the 
physical sector is in the buffer, subsequent writes into that 
physical sector do not require additional prereads. An additional 
saving of disk accesses can be gained by not writing the sector to 
the disk until absolutely necessary. The conditions under which the 
physical sector must be written are discussed in Section 5.3.4. 
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5.3.3 Track Buffering 

Track buffering is a special case of disk buffering where the 
I/O is done a full track at a time. When sufficient memory for 
several full track buffers is available, this method is quite good. 
The method is essentially the same as discussed in Section 5.3.2, 
but there are some interesting features. First, transferring an 
entire track is much more efficient than transferring a single 
sector. The rotational latency is incurred only once for the entire 
track, whereas if the track is transferred one sector at a time, the 
rotational latency occurs once per sector. On a typical diskette 
with 26 sectors per track, rotating at 6 revolutions per second, the 
difference in rotational latency per track is about 2 seconds versus 
a twelfth of a second. Of course, in applications where the disk is 
accessed purely randomly, there is no advantage because there is a 
low probability that more than one sector will be used from a given 
track. However, such applications are extremely rare. 

5.3.4 LRU Replacement 

With any method of disk buffering using more than one buffer, 
it is necessary to have some algorithm for managing the buffers. 
That is, when should buffers be filled, and when should they be 
written back to disk. The first question is simple, a buffer should 
be filled when there is a request for a disk sector that is not 
presently in memory. The second issue, when to write a buffer back 
to disk, is more complicated. 

Generally, it is desirable to defer writing a buffer until it 
becomes necessary. Thus, several transfers can be done to a buffer 
for the cost of only one disk access, two accesses if the buffer had 
to be preread. However, there are several reasons why buffers must 
be written. The following list describes the reasons: 

1) A BIOS Write operation with mode=l (write to directory 
sector). To maintain the integrity of CP/M-68K's file 
system, it is very important that directory information on 
the disk is kept up to date. Therefore, all directory 
writes should be performed immediately. 

2) A BIOS Flush Buffers operation. This BIOS function is 
explicitly intended to force all disk buffers to be 
written. After performing a Flush Buffers, it is safe to 
remove a disk from its drive. 

3) A disk buffer is needed, but all buffers are full. 
Therefore some buffer must be emptied to make it available 
for reuse. 

4) A Warm Boot occurs. This is similar to number 2 above. 
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Case three above is the only one in which the BIOS writer has 
any discretion as to which buffer should be written. Probably the 
best strategy is to write out the buffer which has been least 
recently used. The fact that an area of disk has not been accessed 
for some time is a fairly good indication that it will not be needed 
again soon. 

5.3.5 The New Block Flag 

As explained in Section 5.2.2, the BDOS allocates disk space to 
files in blocks of BLS bytes. When such a block is first allocated 
to a file, the information previously in that block need not be 
preserved. To enable the BIOS to take advantage of this fact, the 
BDOS uses a special parameter in calling the BIOS Write Function. 
If register Dl.W contains the value 2 on a BIOS Write call, then the 
write being done is to the first sector of a newly allocated disk 
block. Therefore, the BIOS need not preread any sector of that 
block. If the BIOS does disk buffering in units of BLS bytes, it 
can simply mark any free buffer as corresponding to the disk address 
specified in this write, because the contents of the newly allocated 
block are not important. If the BIOS uses a buffer size other than 
BLS, then the algorithm for taking full advantage of this 
information is more complicated. 

This information is extremely valuable in reducing disk delays. 
Consider the case where one file is read sequentially and copied to 
a newly created file. Without the information about newly allocated 
disk blocks, every physical write would require a preread. With the 
information, no physical write requires a preread. Thus, the number 
of physical disk operations is reduced by one third. 

End of Section 5 
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Section 6 

Installing and Adapting 

the Distributed BIOS and CP/M-68K 

6.1 Overview 

The process of bringing up your first running CP/M-68K system 
is either trivial or involved, depending on your hardware 
environment. Digital Research supplies CP/M-68K in a form suitable 
for booting on a Motorola EXORmacs development system. If you have 
an EXORmacs, you can read Section 6.1 which tells how to load the 
distributed system. Similarly, you can buy or lease some other 
machine which already runs CP/M-68K. 

If you do not have an EXORmacs, you can use the S-record files 
supplied with your distribution disks to bring up your first CP/M- 
68K system. This process is discussed in Section 6.2. 

6.2 Booting on an EXORmacs 

The CP/M-68K disk set distributed by Digital Research includes 
disks boot and run CP/M-68K on the Motorola EXORmacs. You can use 
the distribution system boot disk without modification if you have a 
Motorola EXORmacs system and the following configuration: 

1) 128K memory (minimum) 

2) a Universal Disk Controller (UDC) or Floppy Disk Controller 
(FDC) 

3) a single-density, IBM 3740 compatible floppy disk drive 

4) an EXORterm TM - 

To load CP/M-68K, do the following: 

1) Place the disk in the first floppy drive (#FD04 with the UDC 
or #FD00 with the FDC) . 

2) Press SYSTEM RESET (front panel) and RETURN (this brings in 
MACSbug™ 1 ) . 

3) Type "BO 4" if you are using the UDC, "BO 0" if you are 
using the FDC, and RETURN. CP/M-68K boots and begins 
running. 
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6-3 Bringing Dp CP/M-68K Using the S-record Files 

The CP/M-68K distribution disks contain two copies of the CP/M- 
68K operating system in Motorola S-record form, for use in getting 
your first CP/M-68K system running. S-records (described in detail 
in Appendix F) are a simple ASCII representation for absolute 
programs. The two S-record systems contain the CCP and BDOS, but no 
BIOS. One of the S-record systems resides at locations 400H and up, 
the other is configured to occupy the top of a 128K memory space. 
(The exact bounds of the S-record systems may vary from release to 
release. There will be release notes and/or a file named README 
describing the exact characteristics of the S-record systems 
distributed on your disks.) To bring up CP/M-68K using the S-record 
files, you need: 

1) some method of down-loading absolute data into your target 
system 

2) a computer capable of reading the distribution disks (a 
CP/M-based computer that supports standard CP/M 8-inch 
diskettes) 

3) a BIOS for your target computer 

Given the above items, you can use the following procedure to 
bring a working version of CP/M-68K into your target system: 

1) You must patch one location in the S-record system to link 
it to your BIOS's _init entry point. This location will be 
specified in release notes and/or in a README file on your 
distribution disks. The patch simply consists of inserting 
the address of the _init entry in your BIOS at one long 
word location in the S-record system. This patching can be 
done either before or after down-loading the system, 
whichever is more convenient. 

2) Your BIOS needs the address of the _ccp entry point in the 
S-record system. This can be obtained from the release 
notes and/or the README file. 

3) Down-load the S-record system into the memory of your target 
computer. 

4) Down-load your BIOS into the memory of your target computer. 

5) Begin executing instructions at the first location of the 
down-loaded S-record system. 

Now that you have a working version of CP/M-68K, you can use 
the tools provided with the distribution system for further 
development. 

End of Section 6 
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Section 7 
Cold Boot Automatic Command Execution 



7.1 Overview 

The Cold Boot Automatic Command Execution feature of CP/M-68K 
allows you to configure CP/M-68K so that the CCP will automatically 
execute a predetermined command line on cold boot. This feature can 
be used to start up turn-key systems, or to perform other desired 
operations. 

7.2 Setting up Cold Boot Automatic Command Execution 

The CBACE feature uses two global symbols: _autost, and 
_usercmd. These are both defined in the CCP, which uses them on 
cold boot to determine whether this feature is enabled. If you want 
to have a CCP command automatically executed on cold boot, you 
should include code in your BIOS's _init routine (which is called at 
cold boot) to do the following: 

1) The byte at _autost must be set to the value 01H. 

2) The command line to be executed must be placed in memory at 
_usercmd and subsequent locations. The command must be 
terminated with a NULL (00H) byte, and may not exceed 128 
bytes in length. All alphabetic characters in the command 
line should be upper-case. 

Once you write a BIOS that performs these two functions, you 
can build it into a CPM.SYS file as described in Section 2. This 
system, when booted, will execute the command you have built into 
it. 



End of Section 7 
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Section 8 
The PUTBOOT Utility 



8.1 PUTBOOT Operation 

The PUTBOOT utility is used to copy information (usually a 
bootstrap loader system) onto the system tracks of a disk. Although 
PUTBOOT can copy any file to the system tracks, usually the file 
being written is a program (the bootstrap system). 

8.2 Invoking PUTBOOT 

Invoke PUTBOOT with a command of the form: 

PUTBOOT [-H] <filename> <drive> 

where 

o -H is an optional flag discussed below; 

• <f ilename> is the name of the file to be written to the system 
tracks; 

o <drive> is the drive specifier for the drive to which 
<filename> is to be written (letter in the range A-P.) 

PUTBOOT writes the specified file to the system tracks of the 
specified drive. Sector skewing is not used; the file is written to 
the system tracks in physical sector number order. 

Because the file that is written is normally in command file 
format, PUTBOOT contains special logic to strip off the first 28 
bytes of the file whenever the file begins with the number 601AH, 
the magic number used in command files. If, by chance, the file to 
be written begins with 601AH, but should not have its first 28 bytes 
discarded, the -H flag should be specified in the PUTBOOT command 
line. This flag tells PUTBOOT to write the file verbatim to the 
system tracks. 

PUTBOOT uses BDOS calls to read <f ilename> , and used BIOS calls 
to write <filename> to the system tracks. It refers to the OFF and 
SPT parameters in the Disk Parameter Block to determine how large 
the system track space is. The source and command files for PUTBOOT 
are supplied on the distribution disks for CP/M-68K. 

End of Section 8 
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Appendix A 
Contents of Distribution Disks 



This appendix briefly describes the contents of the disks 
that contain CP/M-68K as distributed by Digital Research. 



Table A-l. Distribution Disk Contents 



File 


Contents 


AR68.REL 


Relocatable version of the 
archiver/librarian. 


AS68INIT 
AS68.REL 


Initialization file for assembler — see 
AS68 documentation in the CP/M-68K 
Operating System Programmer's Guide. 


Relocatable version of the assembler. 


ASM. SUB 


Submit file to assemble an assembly 
program with file type .S, put the object 
code in filename.O, and a listing file in 
filename. PRN . 


BIOS.O 


Object file of BIOS for EXORmacs. 


BIOS.C 


C language source for the EXORmacs BIOS as 
distributed with CP/M-68K. 


BIOSA.O 


Object file for assembly portion of 
EXORmacs BIOS. 


BIOSA.S 


Source for the assembly language portion 
of the EXORmacs BIOS as distributed with 
CP/M-68K. 


BIOSTYPS.H 


Include file for use with BIOS.C. 


BOOTER.O 


Object for EXORmacs bootstrap. 


BOOTER.S 


Assembly boot code for the EXORmacs. 


C.SUB 


Submit file to do a C compilation. 
Invokes all three passes of the C compiler 
as well as the assembler. You can compile 
a C program with the line: A>C filename. 


C068.REL 


Relocatable version of the C parser. 


C168.REL 


Relocatable version of the C code 
generator. 
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A Contents of Distribution Disks 



Table A-l. (continued) 



File 


Contents 


CLIB 


The C run-time library. 


CLINK. SUB 


Submit file for linking C object programs 
with the C run-time library. 


CP68.REL 


Relocatable version of the C preprocessor. 


CPM.H 


Include file with C definitions for CP/M- 
68K. See the C Programming Guide for 
CP/M-68K for details. 


CPM.REL 


Relocatable version of CPM.SYS. 


CPM.SYS 


CP/M-68K operating system file for the 
EXORmacs. 


CPMLIB 


Library of object files for CP/M-68K. See 
Section 2. 


CPMLDR.SYS 


The bootstrap loader for the EXORmacs. A 
copy of this was written to the system 
tracks using PUTBOOT. 


CTYPE.H 


Same as above. 


DDT.REL 


Relocatable version of the preloader for 
DDT™. (Loads DDT1 into the high end of 
the TPA.) 


DDT1.68K 


This is the real DDT that gets loaded into 
the top of the TPA. It is relocatable 
even though the file type is . 68K, because 
it must be relocated to the top of the TPA 
each time it is used. 


DUMP.REL 


Relocatable version of the DUMP utility. 


ED.REL 


Relocatable version of the ED utility. 


ELDBIOS.S 


Assembly language source for the ERG 
sample loader BIOS. 


ERGBIOS.S 


Assembly language source for the ERG 
sample BIOS. 


ERRNO.H 


Same as above. 


FORMAT. REL 


Relocatable disk formatter for the 
Motorola EXORmacs. 
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Table A-l. (continued) 



File 



Contents 



FORMAT. S Assembly language source for the FORMAT 

utility. 

INIT.REL Relocatable version of the INIT utility. 

INIT.S Assembly language source for the INIT 

utility. 

LCPM.SUB Submit file to create CPM.REL for 

EXORmacs. 

LDBIOS.O Object file of loader BIOS for EXORmacs. 

LDBIOSA.O Object file for assembly portion of 

EXORmacs loader BIOS. 

LDBIOSA.S Source for the assembly language portion 

of the EXORmacs loader BIOS as distributed 
with CP/M-68K. 

LDRLIB Library of object files for creating a 

Bootstrap Loader. See Section 3. 

L068.REL Relocatable version of the linker. 

LOADBIOS.H Include file for use with BIOS.C, to make 

it into a loader BIOS. 

LOADBIOS.SUB Submit file to create loader BIOS for 
EXORmacs. 

MAKELDR.SUB Submit file to create CPMLDR.SYS on 

EXORmac s . 

NORMBIOS.H Include file for use with BIOS.C, to make 

it into a normal. BIOS 

NORMBIOS.SUB Submit file to create normal BIOS for 
EXORmacs. 

NM68.REL Relocatable version of the symbol table 

dump utility. 

PIP.REL Relocatable version of the PIP utility. 

PORTAB.H Same as above. 

PUTBOOT.REL Relocatable version of the PUTBOOT 
utility. 
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Table A-l. (continued) 



File 


Contents 


PUTBOOT.S 


Assembly language source for the PUTBOOT 
utility. 


README.TXT 


ASCII file containing information relevant 
to this shipment of CP/M-68K. This file 
might not be present. 


RELCPM.SUB 


Submit file to relocate CPM.REL into 
CPM.SYS. 


RELOC.REL 


Relocatable version of the command file 
relocation utility. 


RELOCx.SUB b 


This file is included on each disk that 
contains .REL command files, (x is the 
number of the distribution disk containing 
the files) . It is a submit file which 
will relocate the .REL files for the 
target system. 


S.O 


Startup routine for use with C programs — 
must be first object file linked. 


SENDC68.REL 


Relocatable version of the S-record 
creation utility. 


SETJMP.H 


Same as above. 


SIGNAL. H 


Same as above. 


SIZE68.REL 


Relocatable version of the SIZE68 utility. 


SR128K.SYS 


S-record version of CP/M-68K. This 
version has no BIOS, and is provided for 
use in porting CP/M-68K to new hardware. 


SR400.SYS 


S-record version of CP/M-68K. This 
version has no BIOS, and is provided for 
use in porting CP/M-68K to new hardware. 


STAT.REL 


Relocatable version of the STAT utility. 


STDIO.H 


Include file with standard I/O definitions 
for use with C programs. See the C 
Programming Guide for CP/M-68K for 
details. 



End of Appendix A 
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Appendix B 
Sample BIOS Written in Assembly Language 



C P / 


M 6 


8 


A S 


s 


e 


m 


b 


1 e 


Source 


File: 


: a:ergbi 


os.s 












1 
















.. 


2 
















» 


3 
















* 


4 
















» 


5 
















* 


6 
















• 


7 
















** 



9 






.globl 


_init 


10 
11 

12 00000000 






.globl 


_ccp 


2 3FCOOOOOOOE00 00008C 


_init: 


move. 1 


ltraphndl,?8c 


13 0000000A 


4280 




clr.l 


dO 


14 O000O00C 

15 

16 


4E75 




rts 






traphndl: 




17 O000O00E 


0C400017 




crapi 


Jnfuncs.dO 


18 00000012 


6408 




bcc 


trapng 


19 00000014 


E548 




lsl 


#2,d0 


20 00000016 


207B0006 




movea. '. 


1 6 (pc,d0) ,a0 


21 0000001A 


4E90 




jsr 


(a0) 


22 




trapng: 






23 0000001C 


4E7 3 




rte 




25 




biosbase: 




26 0000001E 


00000000 




.del 


_init 


27 00000022 


00O0OO7A 




.del 


wboot 


28 00000026 


00000030 




.del 


constat 


29 0000002A 


00000094 




.del 


conin 


30 0000002E 


O000OOA8 




.del 


conout 


31 00000032 


000000BC 




.del 


lstout 


32 00000036 


OOOOOOBE 




.del 


pun 


33 0000003A 


OOOOOOCO 




.del 


rdr 


34 0000003E 


O0O0OOC8 




.del 


home 


35 00000042 


O000OODO 




.del 


seldsk 


36 00000046 


O000OOF8 




.del 


settrk 


37 0000004A 


O000O10O 




.del 


se tsec 


38 0000004E 


00000114 




.del 


setdma 


39 00000052 


O000O11C 




.del 


read 


40 00000056 


0000015E 




.del 


wr ite 


41 0000005A 


O000OOC2 




.del 


listst 



Revision 02.01 



CP/M-68K BIOS 
Basic Input/Output Subsystem 
For ERG 6800O with Tarbell floppy disk controller 



bios initialization entry point 
ccp entry point 



set up trap #3 handler 
log on disk A, user 



multiply bios function by 4 
get handler address 
call handler 



Listing B-l. Sample Assembly Language BIOS 
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B Sample Assembly Language BIOS 



42 0000005E 00000108 

43 00000062 00000114 

44 00000066 0000029C 

45 0000006A 000002A4 

46 0000006E 000002A6 

47 00000072 00000298 

48 00000076 000002A8 
49 

50 

51 

52 0000007A 4EF900000000 

53 

54 00000080 103900FFFF01 

55 00000086 02400002 
CP/M 68000 Ass 
Source File: a:ergbios.s 

56 0000008A 6704 

57 0000008C 7001 

58 0000008E 4E75 
59 

60 00000090 4280 

61 00000092 4E75 
62 

63 00000094 61EA 

64 00000096 4A40 

65 00000098 67FA 

66 0000009A 103900FFFFOO 

67 00O00OAO COBC0000007F 

68 000000A6 4E75 
69 

70 00O000A8 103900FFFF01 

71 OOOOOOAE C03C0001 

72 O0O0O0B2 67F4 

73 000000B4 13C100FFFF00 

74 O0000OBA 4E75 
75 

76 O0O0O0BC 4E75 



78 000000BE 4E75 

79 

80 000000C0 4E75 

81 

82 000000C2 103C00FF 

83 O0OOOOC6 4E75 
84 

85 



.del 


sectran 




• del 


setdma 




.del 


getseg 




.del 


getiob 




.del 


setiob 




.del 


flush 




.del 


setexc 




nfuncs 


= (*-biosbase)/4 




wboot: jmp 


_ccp 




constat: move. 


b $ffff01,d0 


* get status byte 


andi.w 


t2,d0 


* data available bit on? 


. e r Revision 02.01 


Page 2 





beq 


noton 






moveq.l 


*$l,d0 






rts 






noton: 


clr.l 
rts 


dO 




con in : 


bsr 


constat 






tst 


dO 






beq 


con in 






move. b 


$ffff00, 


,d0 




and. 1 


#$7f,d0 






rts 







* branch if not 

* set result to true 



* set result to false 



see if key pressed 

wait until key pressed 

get key 

clear all but low 7 bits 



* get status 

* check for transmitter buffer empty 

* wait until our port has aged... 

* and output it 

* and exit 



conout: move.b $ffff01,d0 

and.b #$l,d0 

beq conout 

move.b dl,$ffff00 
rts 

lstout: rts 

pun: rts 

rdr: rts 

listst: move.b |$ff,d0 
rts 



Disk Handlers for Tarbell 1793 floppy disk controller 



maxdsk 
dphlen 



iobase 
demd 



this BIOS supports 2 floppy driv 
length of disk parameter header 



$00fffff8 
iobase 



* Tarbell floppy disk port base address 

* output port for command 



Listing B-l. (continued) 
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93 dstat = iobase * input status poet 

94 dtck = iobase+1 * disk track port 

95 dsect = iobase+2 * disk sector port 

96 ddata = iobase+3 * disk data port 

97 dwait = iobase+4 * input port to wait for op finished 

98 dcntrl = iobase + 4 * output control port for drive selection 
99 

100 

101 000000C8 423900000002 home: clr.b track 

102 000000CE 4E75 rts 
103 

104 seldsk: 

105 * select disk given by register dl.b 

106 O00000D0 7000 moveq #0,d0 

107 000000D2 B23C0002 cmp.b »maxdsk,dl * valid drive number? 

108 OO0O00D6 6A1E bpl selrtn * if no, return in dO 

109 000000D8 13C100000000 move.b dl.seldrv * else, save drive number 

110 0O0O00DE E909 lsl.b J4,dl 

CP/M 68000 Assembler Revision 02.01 Page 3 

Source File: a:ergbios.s 

* select code is 00 for drv 0, $10 for dr\ 

* point dO at correct dph 



111 


0O0O00EO 


13C10000000A 




move. b 


dl,selcode 


112 


OO0O00E6 


103900000000 




move. b 


seldrv,d0 


113 


000000EC 


COFC001A 




mulu 


|dphlen,d0 


114 


000000F0 


DOBC00000016 




add.l 


IdphO.dO 


115 


00Q000F6 


4E75 


selrtn: 


rts 




116 












117 


000000F8 


13C10OOOO0O2 


settrk: 


move . b 


dl, track 


118 


OOOOOOFE 


4E75 




rts 




119 












120 


00000100 


13C1O00000O4 


setsec: 


move. b 


dl, sec tor 


121 


00000106 


4E75 




rts 




122 












123 






sectran 






124 






* 


translate sector ir 


125 






* 


result 


in dO 


126 


000O0108 


2042 




movea. 1 


d2,a0 


127 


0O00010A 


48C1 




ext.l 


dl 


128 


Q000010C 


10301000 




move. b 


|0(a0,dl),c 


129 


00000110 


48C0 




ext.l 


dO 


130 


00000112 


4E75 




rts 




131 












132 






se td ma : 






133 


00000114 


23C10O0000O6 




move. 1 


dl,dma 


134 


0000011A 


4E75 




rts 




135 












136 






read: 






137 






* Read 


one sector from reqi 


138 






* Retry 


if necessary, retui 


139 


0000011C 


13FC0OOAO0O000OB 




move . b 


I10,errcnt 


140 






rretry: 






141 


00000124 


61000076 




bsr 


setup 


142 


00000128 


00430088 




ori 


IS88,d3 


143 


0000012C 


13C300FFFFF8 




move»b 


d3,dcmd 



in dO 00 if ok, else non-zero 
* set up retry counter 



OR read command with head load bit 
output it to FDC 



Listing B-l. (continued) 
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144 00000132 0839000700FFFFFC 

145 0000013A 6708 

146 0000013C 10F900FFFFFB 

147 00000142 60EE 
148 

149 00000144 61000146 

150 00000148 6604 

151 0000014A 4280 

152 0000014C 4E75 

153 0000014E 610000BO 

154 00000152 53390000000B 

155 00000158 66CA 

156 0000015A 70FF 

157 0000015C 4E75 
158 

159 

160 

161 

162 0000015E 13FC000A0000000B 

163 

164 00000166 6134 

165 00000168 004300A8 
CP/M 68000 Assen 
Source File: a:ergbios.s 



rloop: 



btst 
beq 
move.b 
bra 

rdone: 

bsc 
bne 
clr.l 
rts 

rerror: bsr 

subq.b 
bne 



#7,dwait 
rdone 

ddata, (a0)+ 
rloop 

r status 

rerror 

dO 

errchk 
t l,errcnt 
rretry 
t$ffffffff,d0 



if end of read, exit 

else, move next byte of data 



get FDC status 



go to error handler 



write: 

* Write one sector to requested disk, track, sector from 

* Retry if necessary, return in dO 00 if ok, else non-zer 

move.b #10,errcnt * set up retry counter 



bsr 
or i 



setup 
I$a8,d3 
vision 02.01 



write comma 
Page 4 



nd with head load bit 



16 6 
167 

16 8 
169 

17 
171 
17 2 
17 3 
17 4 
175 
17 6 
177 
17 8 

17 9 

18 
181 
182 
183 
18 4 
185 

18 6 
187 
188 
189 
190 
191 

19 2 
19 3 
194 



0000016C 13C300FFFFF8 
00000172 0839000700FFFFFC 
0000017A 6708 
0000017C 13D800FFFFFB 
00000182 60EE 

00000184 61000106 
00000188 6604 
0000018A 4280 
0000018C 4E75 
0000018E 6170 
00000190 53390000000B 
00000196 66CE 
00000198 70FF 
0000019A 4E75 



0000019C 13FCO0D0O0FFFFF8 
000001A4 163900000001 
000001AA B63900000000 
000001B0 661A 
000001B2 163900000002 
000001B8 B63900000003 
000001BE 6620 
000001CO 4283 
000001C2 0839000500FFFFF8 
000001CA 6618 



move.b 
btst 
beq 

move. b 
bra 

bsr 

bne 

clr.l 

rts 

bsr 

subq.b 

bne 

move.l 

rts 



d3,dcmd 

#7,dwait 

wdone 

(a0) + , ddata 

wloop 

rstatus 

werror 

dO 

errchk 
t l,errcnt 
wretry 
l$ffffffff,d0 



output it to FDC 



if end of read, exit 

else, move next byte of data 



* get FDC status 



go to error handler 



setup: 

* commo 

* selec 



n read a 
t disk, 
move. b 
move. b 
cmp.b 
bne 
move.b 

bne 
clr.l 
btst 
bne 



nd write setup code 
set track, set secto 

J$d0,dcmd 

curdrv,d3 

seldrv,d3 

newdr ive 

track, d3 

oldtrk,d3 



• all deferred until no 
clear controller, get status 



if drive not selected, do it 



newtrk 
d3 

I5,dstat 
sex it 



if not on right track, do it 

if head already loaded, no head load delay 

if head unloaded, treat as new disk 



Listing B-l. (continued) 



62 



CP/M-68K System Guide 



B Sample Assembly Language BIOS 



195 newdriv 

196 000001CC 13F9000O0O0A00FFFFFC 

197 000001D6 13F90000000000000001 

198 newtrk: 

199 000001EO 6126 

200 000001E2 7604 

201 sexit: 

202 000001E4 13F90000000400FFFFFA 

203 000001EE 13F90000000200FFFFF9 

204 000001F8 207900000006 

205 000001FE 4E75 
206 

207 errchk: 

208 00000200 08070004 

209 00000204 6602 

210 00000206 4E75 
211 

212 chkseek 

213 * 

214 00000208 615C 

215 0000020A 671E 

216 restore 

217 * 

218 0000020C 13FC000B00FFFFF8 

219 rstwait 

220 00000214 0839000700FFFFFC 
CP/M 68000 Assembler 
Source File: a:ergbios.s 



move.b selcode,dcntr 1 
move.b seldrv,curdrv 



bsr 
raoveq 



chkseek 
14, d3 



move.b sector, dsect 

move.b track, dtrk 

roove.l dma,aO 
rts 



btst 

bne 

rts 



|4,d7 
chkseek 



select the drive 



seek to correct track if required 
force head load delay 

set up sector number 
set up track number 
dma address to aO 



if record not found error, reseek 



check for correct track, seek if necessary 



bsr 
beq 



read id 
chksl 



find out what track we're on 

if read id ok, skip restore code 



home the drive and reseek to correct track 

move.b f$0B,dcmd * restore command to command port 



btst |7,dwait 

Revision 02.01 



221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 



0000021C 66F6 

0000021E 0839000200FFFFF8 

00000226 67E4 

00000228 4283 

0000022A 13C300FFFFF9 
00000230 13F90000000200000003 
0000023A B63900000002 
00000240 6722 

00000242 13F90000000200FFFFFB 
0000024C 13FC001800FFFFF8 
00000254 0839000700FFFFFC 
0000025C 66F6 
0000025E 163900FFFFF8 

00000264 4E75 



00000266 13FC00C400FFFFF8 
0000026E 1E3900FFFFFC 
00000274 163900FFFFFB 

0000027A 0839000700FFFFFC 
00000282 6708 



bne 
btst 
beq 
clr.l 

chksl: 

move.b 
move.b 
cmp. b 
beq 

move. b 
move.b 

chks2: btst 



rts 



rstwait 
I 2,dstat 
restore 
d3 

d3,dtrk 
track, oldtrk 
track, d3 
chkdone 
track, ddata 
IS18,dcmd 
I7,dwait 
chks2 
dstat,d3 



loop until restore completed 

if not at track 0, try again 

track number returned in d3 from readid 

update track register in FDC 
update oldtrk 
are we at right track? 
if yes, exit 

else, put desired track in data reg of FDC 
and issue a seek command 

loop until seek complete 
read status to clear FDC 



read track id, return track number in. d3 

move.b t?c4,dcmd * issue read id corr 

move.b dwait,d7 * wait for intrq 

move.b ddata, d3 * track byte to d3 



btst 
beq 



I7,dwait 
rstatus 



ait for intrq 
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246 


00000284 


1E3900FFFFFB 




247 


0000028A 


60EE 




248 








249 


0000028C 


1E3900FFFFF8 




250 


00000292 


0207009D 




251 


00000296 


4E75 




252 








253 








254 








255 


00000298 


4280 




256 


0000029A 


4E75 




257 








258 








259 


0000029C 


203C0000000C 




260 


000002A2 


4E75 




261 








262 








263 


000002A4 


4E75 




264 








265 








266 


000002A6 


4E75 




267 








268 








269 


000002A8 


0281000000FF 




270 


000002AE 


E549 




271 


000002BO 


2041 




272 


000002B2 


2010 




27 3 


000002B4 


2082 




274 


000002B6 


4E75 




27 5 








C P / M 6 8 


A s s e 


m 


Source File: a:ergbios.s 




276 








277 


00000000 






278 








27 9 


00000000 


FF 




280 


00000001 


FF 




281 








28 2 


00000002 


00 




283 


00000003 


00 




284 








28 5 


00000004 


0000 




286 


00000006 


00000000 




287 


O0000O0A 


00 




288 








28 9 


O000000B 


OA 




290 








291 


oooooooc 


0001 




29 2 


OO0O000E 


00000400 




29 3 


00000012 


00017COO 




294 








29 5 








29 6 









move.b ddata,d7 

bra rid2 

move.b dstat,d7 

andi.b I$9d,d7 
rts 



clr.l dO 
rts 



move.l tmemrgn,d0 
rts 



getiob: 



rts 

setexc: 

andi.l l$ff,dl 

lsl t2,dl 

movea. 1 dl,a0 

move.l (a0),d0 

move. 1 d2, (aO) 

noset: rts 

1 e r Revision 02.01 



read another byte 
and loop 



set condition codes 



return successful 



return address of mem region table 



do only for exceptions - 255 
multiply exception nmbr by 4 



return old vector value 
insert new vector 



seldrv: .dc.b $ff 
curdrv: .dc.b $ff 

track: .dc.b 
oldtrk: .dc.b 

sector: .dew 
draa: .del 

selcode: .dc.b 

errcnt: .dc.b 10 

memrgn: .dew 1 * 

.del $400 * 

.del S17c00 * 

* disk parameter headers 



drive requested by seldsk 
currently selected drive 



track requested by settrk 
track we were on 



* drive select code 

* retry counter 

1 memory region 
starts at 400 hex 
goes until 18000 hex 



Listing B-l. (continued) 
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297 






298 


00000016 


0000005A 


299 


0000001A 


0000 


300 


0000001C 


0000 


301 


0000001B 


0000 


302 


00000020 


00000000 


303 


00000024 


0000004A 


304 


00000028 


00000080 


305 


0000002C 


0OOO00AO 


306 






307 


00000030 


0000005A 


308 


00000034 


0000 


309 


00000036 


0000 


310 


00000038 


0000 


311 


0000003A 


00000000 


312 


0000003E 


0000004A 


313 


00000042 


00000090 


314 


00000046 


ooooooco 


315 






316 






317 






318 


0000004A 


001A 


319 


0000004C 


03 


320 


0000004D 


07 


321 


0000004E 


00 


322 


0000004F 


00 


323 


00000050 


00F2 


324 


00000052 


00 3F 


325 


00000054 


COOO 


326 


00000056 


0010 


327 


00000058 


0002 


328 






329 






330 






C P / M 6 8 


1 


Source File: a:ergbios, 


331 


0000005A 


01070D13 


332 


0000005E 


19050B11 


333 


00000062 


17O3090F 


334 


00000066 


1502080E 


335 


0000006A 


141A060C 


336 


0000006E 


1218040A 


337 


00000072 


1016 


338 






339 






340 


00000000 




341 






342 


00000000 




343 






344 


00000080 




345 


00000090 




346 






347 


00O00OA0 





dphO: 



dphl: 



.dew 





.dew 





.del 


dirbuf 


.del 


dpb 


• del 


ckvO 


.del 


alvO 


.del 


xlt 


.dew 





.dew 





.dew 





.del 


dirbuf 


.del 


dpb 



dpb: 



-dew 


242 


.dew 


63 


.dew 


$c000 


-dew 


16 


.dew 


2 



dummy 



ptr to directory buffer 
ptr to disk parameter block 
ptr to check vector 
ptr to allocation vector 



disk parameter block 



dummy 



ptr to directory buffer 

ptr to disk parameter block 

ptr to check vector 

ptr to allocation vector 



sectors per track 

* block shift 

* block mask 

* extent mask 

* dummy fill 
disk size 

64 directory entries 
directory mask 
directory check size 
track offset 



* sector translate table 
s e m b 1 e r Revision 02.01 



xlt: 


.deb 


1. 7, 


13,19 




.deb 


25, 5, 


,11,17 




.deb 


23, 3, 


9,15 




.deb 


21, 2, 


8,14 




.deb 


20,26, 


, 6,12 




.deb 


18,24, 


4,10 




.deb 


16,22 






. bss 






dirbuf: 


.ds.b 


128 


* directory buffer 


ckvO: 


.ds.b 


16 


* check vector 


ckvl: 


.ds.b 


16 





allocation vector 
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348 OOOOOOCO alvl: 

349 

350 OOOOOOEO 
CP/M 68000 Assembler 
Source File: a:ergbios.s 



.ds.b 32 
.end 



Revision 02.01 



Page 



Symbol 



Table 



ccp 


*»»•»»«• 


EXT 


_init 


00000000 


TEXT 


alvO 


000000A0 


BSS 


alvl 


OOOOOOCO 


BSS 


Eiosbase 


0000001E 


TEXT 


chkdone 


00000264 


TEXT 


chksl 


0000022A 


TEXT 


Chks2 


00000254 


TEXT 


chkseek 


00000208 


TEXT 


ckvO 


00000080 


BSS 


ckvl 


00000090 


BSS 


con in 


00000094 


TEXT 


conout 


O00O00A8 


TEXT 


constat 


00000080 


TEXT 


curdrv 


00000001 


DATA 


dcmd 


00FFFFF8 


ABS 


dcntr 1 


OOFFFFFC 


ABS 


ddata 


00FFFFFB 


ABS 


dirbuf 


00000000 


BSS 


dma 


00000006 


DATA 


dpb 


0000004A 


DATA 


dphO 


00000016 


DATA 


dphl 


00000030 


DATA 


dphlen 


0000001A 


ABS 


dsect 


00FFFFFA 


ABS 


dstat 


0OFFFFF8 


ABS 


dtrk 


00FFFFF9 


ABS 


dwait 


OOFFFFFC 


ABS 


errchk 


00000200 


TEXT 


errcnt 


OO0O0O0B 


DATA 


flush 


00000298 


TEXT 


getiob 


000002A4 


IE ■" 


getseg 


0000029C 


TEXT 


home 


OOOO0OC8 


TEXT 


iobase 


00FFFFF8 


ABS 


listst 


O0OO0OC2 


TE> 


lstout 


O0O000BC 


TEXT 


maxdsk 


00000002 


ABS 


memrgn 


OOOOOOOC 


DATA 


newdr ive 


000001CC 


TEXT 


newtrk 


000001EO 


TEXT 


nfuncs 


00000017 


ABS 


noset 


000002B6 


TEXT 


noton 


00000090 


TEXT 


oldtrk 


00000003 


DATA 


pun 


OOOOOOBE 


TEXT 


rdone 


00000144 


TEXT 


rdr 


OOOOOOCO 


TEXT 


read 


0000011C 


TEXT 


readid 


00000266 


TEXT 


rerror 


0000014E 


TEXT 


restore 


0000020C 


TEXT 


rid2 


0000027A 


TEXT 


r loop 


00000132 


TEXT 


rretry 


00000124 


TEXT 


rstatus 


0000028C 


TEXT 


rstwait 


00000214 


TEXT 


sector 


00000004 


DATA 


sectran 


00000108 


TEXT 


selcode 


OOOOOOOA 


DATA 


seldrv 


00000000 


DATA 


seldsk 


0O000ODO 


TEXT 


selrtn 


000000F6 


TEXT 


se tdma 


00000114 


TEXT 


setexc 


000002A8 


TEXT 


se tiob 


000002A6 


TEXT 


setsec 


00000100 


TEXT 


settrk 


OOOO0OF8 


TEXT 


setup 


0000019C 


TEXT 


sex it 


000001E4 


TEXT 


track 


00000002 


DATA 


traphndl 


OOOOOOOE 


TEXT 


trapng 


0000001C 


TEXT 


wboot 


0000007A 


TEXT 


wdone 


00000184 


TEXT 


werror 


0000018E 


TEXT 


wloop 


00000172 


TEXT 


wretry 


00000166 


TEXT 


wr ite 


0000015E 


TEXT 


xlt 


0000005A 


DATA 



Listing B-l. (continued) 
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CP/M 68000 
Source File: a:eldbic 



e m b 1 e r 



Revision 02.01 



CP/M-68K Loader BIOS 
Basic Input/Output Subsystem 
For ERG 68000 with Tarbell floppy disk co 



. globl _bios 



declare external entry point 



00000000 0C400O17 
00000004 6C08 
00000006 E548 
00000008 207B0006 
OOO0000C 4E90 



nogood: 



cmpi tnfuncs,d0 

bge nogood 

lsl #2,d0 

movea.l 6(pc,dO),aO 
jsr (aO) 



multiply bios function by 4 
get handler address 
call handler 



20 0000000E 

21 

22 


4E75 


rts 






biosbase : 




23 00000010 


0000000E 


.del 


nogood 


24 00000014 


OOO00OOE 


.del 


nogood 


25 00000018 


0000006C 


.del 


constat 


26 0000001C 


00000080 


.del 


con in 


27 00000020 


00000094 


.del 


conout 


28 00000024 


0O000O0E 


.del 


nogood 


29 00000028 


O00O0O0E 


.del 


nogood 


30 0000002C 


0O00OO0E 


.del 


nogood 


31 00000030 


000000A8 


.del 


home 


32 00000034 


OO0000BO 


.del 


seldsk 


33 00000038 


0O000OC4 


.del 


settrk 


34 0000003C 


oooooocc 


.del 


setsec 


35 00000040 


0O0000EO 


.del 


setdma 


36 00000044 


00O000E8 


.del 


read 


37 00000048 


0000000E 


.del 


nogood 


38 0000004C 


0OO0000E 


.del 


nogood 


39 00000050 


0O0O00D4 


.del 


sectran 


40 00000054 


OO0000EO 


.del 


setdma 


41 00000058 


0OO0000E 


.del 


nogood 


42 0000005C 


0O0O00OE 


.del 


nogood 



Listing C-l. Sample BIOS Loader 
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43 00000060 0000000E 

44 00000064 0000000E 

45 00000068 00000222 



.dc. 1 nogood 
.del nogood 
.dc. 1 se texc 

nfuncs= (*-biosbase)/4 



50 


0000006C 


103900FFFF01 


51 


00000072 


02400002 


52 


00000076 


6704 


53 


00000078 


7001 


54 


0000007A 


4E75 


55 






C P / 


M 6 8 


As 


Source File: e 


:eldbios. s 


56 


0000007C 


4280 


57 


0000007E 


4E75 


58 






59 


00000080 


61EA 


60 


00000082 


4A40 


61 


00000084 


67FA 


62 


00000086 


103900FFFF00 


63 


0O00008C 


COBC0000007F 


64 


00000092 


4E75 


65 






66 


00000094 


103900FFFF01 


67 


0000009A 


C03C0001 


68 


0000009E 


67F4 


69 


000000A0 


13C100FFFF00 


70 


000000A6 


4E75 


71 






72 






73 






74 







s e ra b 1 e r 



: move.b S£fff01,d0 
ahdi.w 12, dO 
beq noton 

moveq. 1 151 /dO 
rts 

Revision 02.01 



78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 

89 OO0O00A8 423900000002 

90 OO0O0OAE 4E75 
91 

92 
93 
94 OO0O00B0 423900000000 



noton: 


clr.l 
rts 


dO 


conin : 


bsr 


constat 




tst 


dO 




beq 


conin 




move. b 


?ff£f00,d0 




and. 1 


#S7f,dO 




rts 




conout: 


move. b 


$ffff01,d0 




and. b 


t$l,d0 




beq 


conout 




move.b 


dl,$ffff00 




rts 





get status byte 

data available bit on? 

branch if not 

set result to true 



set result to false 



see if key pressed 

wait until key pressed 

get key 

clear all but low 7 bits 



get status 

check for transmitter buffer empty 

wait until our port has aged... 

and output it 

and exit 



Disk Handlers for Tarbell 1793 floppy disk controller 

this BIOS supports 2 floppy drives 
length of disk parameter header 

Tarbell floppy disk port base address 

output port for command 

input status port 

disk track port 

disk sector port 

disk data port 

input port to wait for op finished 

output control port for drive selection 



select drive A 



maxdsk 


=2 * this 


dphlen 


=26 * leng 


iobase 


= ?00fffff8 


dcrnd 


= 


obase 


dstat 


= 


obase 


dtrk 


= 


obase+1 


dsect 


= 


obase+2 


ddata 


= 


obase+3 


dwait 


= 


obase+4 


dcntrl 


= 


obase+4 


home: 


cl 
rt 


. b track 


seldsk: 






* 


se 


Lect disk A 




cl 


'.b seldrv 



Listing C-l. (continued) 



68 



CP/M-68K System Guide 



C Sample Loader BIOS 



95 000000B6 42390000000A 

96 000000BC 203C0000O00C 

97 0000OOC2 4E75 
98 

99 000000C4 13C100000002 
100 OOOOOOCA 4E75 
101 

102 000000CC 13C100000004 

103 000000D2 4E75 
104 

105 
106 
107 

108 000000D4 2042 

109 OOOOO0D6 48C1 

110 O000O0D8 10301000 
CP/M 68000 Ass 
Source File: a:eldbios.s 



clr.b selcode * select code is 00 for drv 0, 510 for drv 1 

move.l JdphO.dO 
selrtn: r ts 

settrk: move.b dl, track 
rts 

setsec: move.b dl, sector 
rts 

sec tran: 

* translate sector in dl with translate table pointed to by d2 

* result in dO 
movea. 1 d2,a0 
ext.l dl 

move.b |0(a0,dl),d0 
bier Revision 02.01 Page 3 



111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 



OOOOOODC 48C0 
OOOOOODE 4E75 



OOOOOOEO 23C100000006 
00Q000E6 4E75 



000000E8 13FC000A0000000B 

OOOOOOFO 6134 
000000F2 00430088 
000000F6 13C300FFFFF8 
0O00O0FC 0839000700FFFFFC 
00000104 6708 
00000106 10F900FFFFFB 
0000&10C 60EE 

0000010E 61000106 

00000112 6604 

00000114 4280 

00000116 4E75 

00000-118 6170 

000001LA 53390000000B 

000001.20 66CE 

00000122 70FF 

00000124 4E75 



00000126 13FC00D000FFFFF8 
0000012E 163900000001 



ext. 1 
rts 



move.l dl.dma 
rts 



read: 

* Read one sector from requested disk, track, sector to dma 

* Retry if necessary, return in dO 00 if ok, else non-zero 



move.b 110, err en t 

rretry: 

bsr setup 

ori |$88,d3 

move. b d3 ,dcmd 

rloop: btst #7,dwait 

beq rdone 

move.b ddata,(a0)+ 

bra rloop 

rdone: 

bsr rstatus 

bne terror 

clr.l dO 
rts 

terror: bsr errchk 

subq.b #l,errcnt 

bne rretry 

move.l |?ffffffff,d0 
rts 



setup: 

* common read and write setup code 

* select disk, set track, set sector were all deferred until now 

move.b i$d0,dcmd * clear controller, get status 

move.b curdrv,d3 



* set up retry counter 



OR read command with head load bit 
output it to FDC 



if end of read, exit 

else, move next byte of data 



get FDC status 



go to error handler 
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147 00000134 B63900000000 

148 0000013A 661A 

149 0000013C 163900000002 

150 00000142 B63900000003 

151 0000014B 6620 

152 0000014A 4283 

153 0000014C 0839000500FFFFF8 

154 00000154 6618 
155 

156 00000156 13F90000000A00FFFFFC 

157 00000160 13F90000000000000001 
158 

159 OO0O016A 6126 

160 0000016C 7604 
161 

162 0000016E 13F90000000400FFFFFA 

163 00000178 13F90000000200FFFFF9 

164 00000182 207900000006 

165 00000188 4E75 

CP/M 68000 Asserab: 
Source File: a:eldbios.s 





cmp. b 


seldrv,d3 




bne 


newdr ive 




move. b 


track, d3 




cmp.b 


oldtrk,d3 




bne 


newtrk 




clr.l 


d3 




btst 


I5,dstat 




bne 


sexit 


newdr ive: 






move.b 


selcode,dcntrl 




move. b 


se ldrv, curdrv 


newtrk: 








bsr 


chkseek 




moveq 


|4,d3 


sexit: 








mov e . b 


sector , dsect 




move. b 


track, dtrk 




move. 1 


dma.aO 




rts 





Revision 02.01 



if drive not selected, do it 



if not on right track, do it 

if head already loaded, no head load delay 

if head unloaded, treat as new disk 



select the drive 



seek to correct track if required 
force head load delay 

set up sector number 
set up track number 
dma address to aO 

Page 4 



166 






167 




errchk: 


168 0000018A 


08070004 




169 0000018E 


6602 




170 00000190 


4E75 




171 






172 




chkseek 


173 




* 


174 00000192 


615C 




175 00000194 


671E 




176 




restore 


177 




* 


178 00000196 


13FC000B00FFFFF8 




179 




rstwait 


180 0000019E 


0839000700FFFFFC 




181 000001A6 


66F6 




182 000001A8 


0839000200FFFFF8 




183 000001BO 


67E4 




184 000001B2 


4283 




185 




chksl: 


186 000001B4 


13C300FFFFF9 




187 000001BA 


13F90000000200000003 




188 000001C4 


B63900000002 




189 000001CA 


6722 




190 000001CC 


13F 90000000 200FFFFFB 




191 000001D6 


13FC001800FFFFF8 




192 000001DE 


08390007 00FFFFFC 


chks2: 


193 000001E6 


66F6 




194 000001E8 


163900FFFFF8 




195 




chkdone 


196 000001EE 


4E75 




197 






198 




re ad id: 



btst 14, d7 
bne chkseek 
rts 



if record not found error, reseek 



check for correct track, seek if necessary 

bsr readid * find out what track we're on 

beq chksl * if read id ok, skip restore code 

home the drive and reseek to correct track 



move.b t$0B,dcmd 

btst I7,dwait 

bne rstwait 

btst |2,dstat 

beq restore 

clr.l d3 

move.b d3,dtrk 

move.b track, oldtrk 

cmp.b track, d3 

beq chkdone 

move.b track, ddata 

move.b #S18,dcmd 

btst I7,dwait 

bne chks2 

move.b dstat,d3 

rts 



* restore command to command port 

* loop until restore completed 

* if not at track 0, try again 

* track number returned in d3 from readid 

* update track register in FDC 

* update oldtrk 

* are we at right track? 

* if yes, exit 

* else, put desired track in data reg of FDC 

* and issue a seek command 

* loop until seek complete 

* read status to clear FDC 
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199 

200 000001FO 13FC00C400FFFFF8 

201 000001F8 1E3900FFFFFC 

202 000001FE 163900FFFFFD 
20 3 

204 00000204 08 39000700FFFFFC 

205 0000020C 6708 

206 0000020E 1E3900FFFFFB 

207 00000214 60EE 
208 

209 00000216 1E3900FFFFF8 

210 0000021C 0207009D 

211 00000220 4E75 
212 

213 
214 

215 00000222 0281000000FF 

216 00000228 E549 

217 0000022A 2041 

218 0000022C 2010 

219 0000022E 2082 

220 00000230 4E75 

CP/M 68000 A s s e r 
Source File: a:eldbios.s 



read track id, return track number in d3 



move. b 



I$c4 , dcmd 

dwait,d7 

ddata,d3 



btst I7,dwait 

beq rstatus 

move.b ddata,d7 

bra rid2 



rstatus 








move. b 


dstat,d7 




andi. b 


I$9d,d7 




rts 




setexc: 








andi.l 


»$ff,dl 




lsl 


»2,dl 




movea. 1 


dl,a0 




move. 1 


(a0),d0 




move. 1 


d2, (aO) 




rts 




L e r 


Re' 


/ision 02.01 



issue read id command 
wait for intrq 
track byte to d3 



wait for intrq 
read another byte 
and loop 



set condition codes 



do only for exceptions - 255 
multiply exception number by 4 



return old vector value 
insert new vector 



221 






222 






223 


00000000 




224 






225 


00000000 


FF 


226 


00000001 


FF 


227 






228 


00000002 


00 


229 


00000003 


00 


230 






231 


00000004 


0000 


232 


00000006 


00000000 


233 


OO0000OA 


00 


234 






235 


OO00000B 


0A 


236 






237 






238 






239 






240 


oooooooc 


00000036 


241 


00000010 


0000 


242 


00000012 


0000 


243 


00000014 


0000 


244 


00000016 


00000000 


245 


0000001A 


00000026 


246 


0000001E 


00000000 


247 


00000022 


00000000 


248 






249 






250 







seldrv: 
curdrv: 



track: 
oldtrk: 



Sff 

$ff 



.dc.b 
.dc.b 



sector: .dew 

dma: . dc. 1 

selcode: .dc.b 

errcnt: .dc. b 



disk parameter headers 



dphO: 



.del 
.dew 
.dew 
.dew 
.del 
.del 
.del 



xlt 



drive requested by seldsk 
currently selected drive 



track requested by settrk 
track we were on 



drive select code 
retry counter 



dummy 



dirbuf * ptr to directory buffer 
dpb * ptr to disk parameter block 

ptr to check vector 



ptr to allocation vector 



* disk parameter block 
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251 

252 00000026 001A 

253 00000028 03 

254 00000029 07 

255 0000002A 00 

256 0000002B 00 

257 0000002C 00F2 

258 0000002E 003F 

259 00000030 C000 

260 00000032 0010 

261 00000034 0002 
262 

263 
264 

265 00000036 01070D13 

266 0000003A 19050B11 

267 0000003E 1703090F 

268 00000042 1502080E 

269 00000046 141A060C 

270 0000004A 1218040A 

271 0000004E 1016 
272 

273 

274 00000000 

275 
CP/M 68000 
Source File: a:eldbi 



dpb 



b: .dew 




26 


» 


sectors per track 


.dc. 


b 


3 




* block shift 


.dc. 


b 


7 




* block mask 


.dc. 


b 







* extent mask 


.dc. 


b 







* dummy fill 


.dew 




242 


* 


disk size 


.dew 




63 


* 


64 directory entries 


.dew 




$c000 


* 


directory mask 


.dc. w 




16 


* 


directory check size 


. dew 




2 


* 


track offset 


sector translate table 




.t: .deb 




1. 7, 


13, 


19 


.deb 




25, 5, 


,11, 


17 


.deb 




23, 3, 


9, 


15 


.deb 




21, 2, 


8, 


14 


.deb 




20,26, 


, 6, 


12 


.deb 




18,24, 


4, 


10 


.deb 




16,22 







Assembler 



Revision 02.01 



276 00000000 
277 






dirbuf: , 


ds.b 


128 


* directory buffer 






278 

279 00000080 








.end 














CP/M 


6 8 A 


s s e m b 


1 e r 


Revision 02 


.01 


Page 7 






Source File: a:eldbios.s 




















S y m b o 


1 Table 




















_bios 


00000000 


TEXT 


biosbase 


00000010 


TEXT 


chkdone 


000001EE 


TEXT 


chksl 


000001B4 


TEXT 


chks2 


000001DE 


TEXT 


chkseek 


00000192 


TEXT 


con in 


00000080 


TEXT 


conout 


00000094 


TEXT 


constat 


0000006C 


TEXT 


curdrv 


00000001 


DATA 


demd 


00FFFFF8 


ABS 


dcntrl 


00FFFFFC 


ABS 


ddata 


00FFFFFB 


ABS 


dirbuf 


00000000 


BSS 


dma 


00000006 


DATA 


dpb 


00000026 


DATA 


dphO 


oooooooc 


DATA 


dphlen 


0000001A 


ABS 


dsect 


00FFFFFA 


ABS 


dstat 


0OFFFFF8 


ABS 


dtrk 


00FFFFF9 


ABS 


dwait 


0FFFFFC 


ABS 


errchk 


0000018A 


TEXT 


errcnt 


OOO0O0OB 


DATA 


hd)ne 


OOO00OA8 


TEXT 


iobase 


O0FFFFF8 


ABS 


maxdsk 


00000002 


ABS 


newdr ive 


00000156 


TEXT 


newtrk 


0000016A 


TEXT 


nfuncs 


00000017 


ABS 


nogood 


0000000E 


TEXT 


no ton 


0000007C 


TEXT 


oldtrk 


00000003 


DATA 


rdone 


0000010E 


TEXT 


read 


OOOOO0E8 


TEXT 


readid 


000001FO 


TEXT 


rerror 


00000118 


TEXT 


restore 


00000196 


TEXT 


rid2 


00000204 


TEXT 


rloop 


OOOOOOFC 


TEXT 


rretry 


OOO00OFO 


TEXT 


rstatus 


00000216 


TEXT 


rstwait 


0000019E 


TEXT 


sector 


00000004 


DATA 


sectran 


000000D4 


TEXT 


selcode 


OOOOOOOA 


DATA 


seldrv 


00000000 


DATA 


seldsk 


OOOOOOBO 


TEXT 


selr tn 


OO0OOOC2 


TEXT 


setdma 


OOOOOOEO 


TEXT 


setexc 


00000222 


TEXT 


setsec 


oooooocc 


TEXT 


settrk 


000000C4 


TEXT 


setup 


00000126 


TEXT 


sex it 


0000016E 


TEXT 


track 


00000002 


DATA 


xlt 


00000036 


DATA 





















Listing C-l. (continued) 



End of Appendix C 



72 



Appendix D 
EXORmacs BIOS Written in C 



This Appendix contains several files in addition to the C 
BIOS proper. First, the C BIOS includes conditional compilation to 
make it into either a loader BIOS or a normal BIOS, and there is an 
include file for each possibility. One of these include files 
should be renamed BIOSTYPE.H before compiling the BIOS. The choice 
of which file is used as BIOSTYPE.H determines whether a normal or 
loader BIOS is compiled. Both the normal and the loader BlOSes need 
assembly language interfaces, and they are not the same. Both 
assembly interface modules are given. Finally, there is an include 
file that defines some standard variable types. 

BIOS.C 
This is the main text of the C language BIOS for the EXORmacs. 



/*' 

/*/ 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 



CP/M-68K(tm) BIOS for the EXORMACS 

Copyright 1982, Digital Research. 

Modified 9/ 7/82 wbt 
10/ 5/82 wbt 
12/15/82 wbt 
12/22/82 wbt 



{include "biostype.h" /* defines LOADER : 0-> normal bios, l->loader bios */ 
/* also defines CTLTVPE -> Universal Disk Cntrlr */ 
/* 1 -> Floppy Disk Controller */ 

tinclude "biostyps.h" /* defines portable variable types */ 

char copyright!] = "Copyright 1982, Digital Research"; 

struct memb | BYTE byte; J; /* use for peeking and poking memory */ 

struct memw J WORD word; 
struct meml I LONG lword; 



I/O Device Definitions 



[Listing D-l. EXORmacs BIOS Written in C 
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♦ define NAK 



1 define PKTSTX 


0x0 


Idefine PKTID 


0x1 


Idefine PKTSZ 


0x2 


Idefine PKTDEV 


0x3 


Idefine PKTCHCOM 


i 0x4 


Idefine PKTSTCON 


1 0x5 


Idefine PKTSTVAL 


0x6 


Idefine PKTSTPRM 


1 0x8 


Idefine STPKTSZ 


Oxf 


/..*..»*........ 


***•******•: 


/* BIOS Table Definitions 


/*************** 


***********' 


/* Disk Parameter Block Str 


struct dpb 
{ 




WORD 


spt; 


BYTE 


bsh; 


BYTE 


blm; 


BYTE 


exm; 


BYTE 


dpbjunk; 


WORD 


dsm; 


WORD 


drm; 


BYTE 


alO; 


BYTE 


all; 


WORD 


cks; 


WORD 


off; 



/* offsets within a disk packet */ 



/* Disk Parameter Header Structure */ 



struct 
l 


dph 




l 


BYTE 


*xltp; 




WORD 


dph sc r [ 3 ] 




BYTE 


*dirbufp; 


struct 


dpb 


*dpbp; 




BYTE 


*csvp; 


}; 


BYTE 


*alvp; 



/* Directory Buffer for use by the BDOS */ 

BYTE dirbuf [128]; 
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/* 


(dsmO / 8) 


+ 


1 


V 


/* 


(dsml / 8) 


+ 


1 


V 


/* 


(dsm2 / 8) 


+ 


1 


V 


/* 


(dsm2 / 8) 


+ 


1 


V 



I if 1 LOADER 

/* CSV's */ 

BYTE csv0[16); 

BYTE csvlll6]; 

BYTE csv2[256]; 

BYTE csv3[256); 

/* ALV's */ 

BYTE alv0[32]; 

BYTE alvl[32]; 

BYTE alv2[412); 

BYTE alv3[412] ; 

lendif 

/* Disk Parameter Blocks */ 

/* The following dpb definitions express the intent of the writer, */ 

/* unfortunately, due to a compiler bug, these lines cannot be used. */ 

/* Therefore, the obscure code following them has been inserted. */ 

/************* spt, bsh, blm, exm, jnk, dsra, drm, alO, all, cks, off 

struct dpb dpbO={ 26, 3, 7, 0, 0, 242, 63, OxCO, 0, 'l6, 2} 
struct dpb dpb2={ 32, 5, 31, 1, 0, 3288, 1023, OxFF, 0, 256, 4} 

********** end of readable definitions ********•»****/ 

/* The Alcyon C compiler assumes all structures are arrays of int, so */ 
/* in the following definitions, adjacent pairs of chars have been */ 

/* combined into int constants what a kludge! **********************/ 

struct dpb dpbO = { 26, 775, 0, 242, 63, -16384, 16, 2 ); 
struct dpb dpb2 = { 32, 1311, 256, 3288, 1023, OxFFOO, 256, 4 }; 

/*#********•«»** End of kludge *****************/ 



/* Sector Translate Table for Floppy Disks */ 

BYTE xlt[26] = 1 1, 7, 13, 19, 25, 5, 11, 17, 23, 3, 9, 15, 21, 
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2, 8, 14, 20, 26, 6, 12, 18, 24, 4, 10, 16, 22 }; 



Disk Parameter Headers 



Four disks are defined 



dsk 
dsk 
dsk 
dsk 



diskno=0, (Motorola's Jfd04) 

diskno=l, (Motorola's I fd05) 

diskno=2, (Motorola's JhdOO) 

diskno=3, (Motorola's thdOl) 



/* Disk Parameter Headers */ 
struct dph dphtab[4] 



ixlt, 0, 0, 0, Sdirbuf, &dpt>0, icsvO, ialvOj 

6xlt, 0, 0, 0, Sdirbuf, &dpb0, &csvl, Salvll 

0L, 0, 0, 0, tdirbuf, &dpb2, £.csv2, ialv2j 

0L, 0, 0, 0, Sdirbuf, &dpb2, &csv3, ialv3) 



/*dsk a*/ 
/*dsk b*/ 
/♦dsk c*/ 
/*dsk d*/ 



Se lse 

struct dph dphtab[4] 



ixlt, 0, 0, 0, sdirbuf, 

Sxlt, 0, 0, 0, sdirbuf, 

0L, 0, 0, 0, Sdirbuf, 

0L, 0, 0, 0, sdirbuf, 



&dpb0 , 
SdpbO, 
S,dpb2, 
Sdpb2, 



/* Memory Region Table 



/*dsk 
/*dsk 
/*dsk 
/*dsk 


a*/ 
b*/ 
c*/ 

d*/ 


***** 


'**/ 


****** 


*/ 



struct rart 



WORD count; 
LONG tpalow; 
LONG tpalen; 



memtab = { 1, 0x0400L, Oxl4c00L }; 



t if ! LOADER 



/* IOBYTE 



WORD iobyte; /* The I/O Byte is defined, but not used */ 

{endif 
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/******** / 

/* Currently Selected Disk Stuff */ 

WORD settrk, setsec, setdsk; /* Currently set track, sector, disk */ 

DVTE *setdma; /* Currently set dma address */ 



/* Track Buffering Definitions and Variables */ 

I if ! LOADER 

Idefine NUMTB 4 /* Number of track buffers — must be at least 3 */ 

/* for the algorithms in this BIOS to work properly */ 

/* Define the track buffer structure */ 

struct tbstr ( 

struct tbstr *nextbuf; /* form linked list for LRU */ 

BYTE buf [32*128]; /* big enough for 1/4 hd trk */ 

WORD dsk; /* disk for this buffer */ 

WORD trk; /* track for this buffer */ 

BYTE valid; /* buffer valid flag */ 

BYTE dirty; /* true if a BIOS write has */ 

/* put data in this buffer, */ 

/* but the buffer hasn't been */ 

/* flushed yet. */ 

1; 

struct tbstr *firstbuf; /* head of linked list of track buffers */ 
struct tbstr *lastbuf; /* tail of ditto */ 

struct tbstr tbuf [NUMTB]; /* array of track buffers */ 

lelse 

/* the loader bios uses only 1 track buffer */ 

BYTE bufltrk[ 32*128]; /* big enough for 1/4 hd trk */ 
BYTE bufvalid; 
WORD buftrk; 



/* Disk I/O Packets for the UDC and other Disk I/O Variables */ 
/* Home disk packet */ 

Listing D-L. (continued) 
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struct hmpkst { 



BYTE 


al; 


BYTE 


a2; 


BYTE 


a3; 


BYTE 


dskno; 


BYTE 


coml; 


BYTE 


com2; 


BYTE 


a6; 


BYTE 


a7; 



hmpack = ( 512, 1792, 0, 768 ); /* kludge init by words */ 



/* Read/write disk packet */ 



struct rwpkst 



BYTE 


stxcht ; 


BYTE 


pktid; 


BYTE 


pk tsize 


BYTE 


dskno; 


BYTE 


chcmd; 


BYTE 


devcmd; 


WORD 


numblks 


WORD 


blksize 


LONG 


iobf; 


WORD 


cksum; 


LONG 


lsect; 


BYTE 


etxchr ; 


BYTE 


rwpad; 



struct rwpkst rwpack = { 512, 5376, 4097, 13, 256, 0, 0, 0, 0, 0, 768 }; 

♦ if ! LOADER 

/* format disk packet */ 

struct fmtpkst { 



BYTE 


fmtstx; 


BYTE 


fmtid; 


BYTE 


fmtsize; 


BYTE 


fmtdskno; 


BYTE 


fmtchcind; 


BYTE 


fmtdvcmd; 


BYTE 


fmtetx; 


BYTE 
b 


fmtpad; 



struct fmtpkst fmtpack = { 512, 1792, 0x4002, 0x0300 ); 
t endif 



/* Define the number of disks supported and other disk 
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/* Generic serial port input */ 

BYTE portin(port) 
REG BYTE *port; 

while ( I por tstat(por t) ) ; /* wait for input */ 

return ( * (port + PORTRDR) ) ; /* got some, return it */ 

/* Generic serial port output */ 

por tou t(por t, ch) 

REG BYTE *port; 

REG BYTE ch J 

{ 

while ( 1 (Mport + PORTSTAT) & PORTTDRE) ) ; /* wait for ok bo send */ 
* (port + PORTTDR) = ch; /* then send character */ 



/* Error procedure for BIOS */ 

#if ! LOADER 

bioserr (errmsg) 
REG BYTE *errmsg; 
{ 

printstr ("nrBIOS ERROR — "); 

pr intstr (errmsg) ; 

printstr(".nr") ; 

printstr (s) /* used by bioserr */ 

REG BYTE *s; 

while (*s) {por tout(PORTl,*s) ; s += 1; }; 

t else 

bioserr () /* minimal error procedure for loader BIOS */ 

1 : goto 1; 



tend if 
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/' Disk I/O Procedures */ 

EXTERN dskia(); /* external interrupt handler -- calls dskic */ 

EXTERN setimasM); /* use to set interrupt mask — returns old mask */ 

dskic() 

/* Disk Interrupt Handler — C Language Portion */ 

REG BYTE wor kbyte; 
BYTE stpkt[STPKTSZ] ; 

workbyte = (DSKIPC + ACKFMIPC) ->by te; 

if ( (workbyte == ACK) | | (workbyte == NAK) ) 

if ( ipcstate == ACTIVE ) intcount += 1; 

else (DSKIPC + ACKFMIPC)->byte = 0; /* ??? */ 

workbyte = (DSKIPC + MSGFMIPC) ->byte; 
if ( workbyte & 0x80 ) 

getstpkt(stpkt) ; 

if ( stpkt[PKTID] == OxPF ) 

/* unsolicited */ 

unsolst(stpkt) ; 
sendack( ) ; 



/* solicited */ 

if ( ipcstate == ACTIVE ) intcount += 1; 
else sendack() ; 



} /* end of dskic */ 

/* Read status packet from IPC */ 

gets tpk t ( s tpk tp) 
REG BYTE *stpktp; 

REG BYTE *p, *q; 
REG WORD i; 
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stpktp; 

(DSKIPC + PKTFMIPC) 



for ( i » STPKTSZ; i; i 



*P = *q 

p += 1 
q += 2 



/* Handle Unsolicited Status from IPC 



unsolst (stpktp) 
REG BYTE *stpktp; 



REG WORD dev; 

REG WORD ready; 

REG struct dskst *dsp; 

dev = rcnvdsM (stpk tp+PKTDEV) -> by te ) ; 

ready = ( ( stpk tp+PKTSTPRM) ->byte i. 0x80) == 0x0; 

dsp = & dskstate[ dev) ; 

if ( ( ready il. ! (dsp->ready) ) || 

(iready) S& (dsp->ready) ) dsp->change = 1; 

dsp->ready = ready; 
fif ! LOADER 

if ( ! ready ) se tinv Id (dev) ; /* Disk is not ready, mark buffers */ 
t endif 



(if ! LOADER 



/* Mark all buffers for a disk as not valid 

setinvld(dsk) 
REG WORD dsk; 
{ 

REG struct tbstr *tbp; 

tbp = firstbuf; 
while ( tbp ) 

if ( tbp->dsk == dsk ) tbp->valid = 0; 
tbp = tbp->nextbuf ; 
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iopackp = (DSKIPC + PKTTOIPC) ; 

do l*iopackp = *pktadr++; iopackp +- 2; pktsize -- lj } vh ile (pk tsize) ; 

(DSKIPC+MSGTOlPC)->byte - 0x80; 

imsave = se timask (7 ) ; 

dskstate[actvdsk) . state = ACTIVE; 

ipcstate = ACTIVE; 

intcount = 0L; 

(DSKIPC + INTTOIPC) ->byte = 0; 

se timask ( imsave) ; 

wa itack ( ) ; 

/* Wait for a Disk Operation to Finish */ 

WORD dskwait(dsk, stcora, stval) 

REG WORD dsk; 

BYTE stcora; 

WORD stval; 

1 

REG WORD imsave; 

BYTE stpkt[STPKTSZ] ; 

imsave = setimask(7); 
while ( (! intcount) && 

dskstate[dsk] .ready is. (! d sk sta te[ dsk] . change) ) 

se timask ( imsave) ; imsave = setimask(7); 

if ( intcount ) 

intcount -= 1; 

if ( ( (DSKIPC + MSGFMIPC)->byte & 0x80 ) == 0x80 ) 

getstpkt(stpkt) ; 

setimaskj imsave) ; 

if ( (stpktIPKTSTCOH] == stcom) !.£, 

( (stpkt+PKTSTVAL)->word == stval 1 ) return (1) ; 
else return (0) ; 

setimask ( imsave) ; 
return(O) ; 

/* Do a Disk Read or Write */ 

dskxfer(dsk, trk, bufp, cmd) 
REG WORD dsk, trk, cmd; 
REG BYTE *bufp; 
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/* build packet */ 

REG WORD sectcnt; 
REG WORD result; 

i if CTLTYPE 

LONG bytecnt; /* only needed for FDC */ 

WORD cheksum; 
I end if 

rwpack.dskno » cnvdsk [ dsk] ; 

rwpack. iotrf ■■ t>ufp; 

sectcnt " (dphtab[dsk) .dpbp) ->spt; 

rwpack. lsect = trk * (sectcnt >> 1); 

rwpack.chcmd = cmd; 

rwpack. numblks = (sectcnt >> 1); 

I if CTLTYPE 

cheksum =■ 0; /* FDC needs checksum */ 

bytecnt =■ ( (LONG) sec tent) << 7; 

while ( bytecnt — ) cheksum += (" (* bufp++ ) ) S. Oxff; 

rwpack. cksum = cheksum; 
tend if 

actvdsk = dsk; 

dskstate[dsk] . change = 0; 

sendpktl&rwpack, 21); 

result = dskwait(dsk, 0x70, 0x0); 

sendack ( ) ; 

dsksta te[dsk] . state = IDLE; 

ipestate = IDLE; 

return ( result) ; 



tif ! LOADER 

/* Write one disk buffer */ 

flushl(tbp) 
struct tbstr *tbp; 
1 

REG WORD ok; 

if ( tbp->valid && tbp->dirty ) 

ok = dskxfer ( tbp->dsk, tbp->trk, tbp->buf, DSKWRITE) ; 
else ok = 1; 

tbp->dirty = 0; /* even if error, mark not dirty */ 

tbp->valid 4= ok; /* otherwise system has trouble */ 

/* continuing. */ 
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/* Write all disk buffers */ 



REG struct tbstr *tbp; 
REG WORD ok; 



ok = 1; 

tbp = firstbuf; 

while (tbp) 

if ( ! f lushl (tbp) ) ok = 0; 
tbp = tbp->nextbuf ; 

return (ok) ; 



/* Fill the indicated disk buffer with the current track and sector */ 



fill (tbp) 

REG struct tbstr *tbp; 



REG WORD ok; 



if ( tbp->valid && tbp->dirty ) ok = f lushl (tbp) ; 
else ok = 1; 

if (ok) ok = dskxfer (setdsk, settrk, tbp->buf, DSKREAD) ; 

tbp->valid = ok; 

tbp->dirty = 0; 

tbp->trk = settrk; 

tbp->dsk = setdsk; 

return(ok) ; 



/* Return the address of a track buffer structure containing the */ 
/* currently set track of the currently set disk. */ 

struct tbstr *gettrk() 

REG struct tbstr *tbp; 
REG struct tbstr *ltbp; 
REG struct tbstr *mtbp; 
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REG WORD imsave; 

/* Check for disk on-line — if not, return error */ 

imsave = setimask(7); 

if ( ! dskstate[ setdsk) .ready ) 

setimask ( imsave) ; 
tbp = OL; 
return (tbp) ; 



/* Search through buffers to see if the required stuff */ 
/* is already in a buffer */ 



tbp = firstbuf; 
ltbp = 0; 
mtbp = 0; 

while (tbp) 



if ( (tbp->valid) it. (tbp->dsk == setdsk) 
&& (tbp->trk == settrk) ) 

if (ltbp) /* found it — rearrange LRU links */ 

ltbp->nextbuf = tbp->nex tbuf ; 
tbp->nextbuf = firstbuf; 
firstbuf = tbp; 



} 
else 



setimask ( imsave) ; 
return ( tbp ) ; 



mtbp = ltbp; /* move along to next buffer */ 

ltbp = tbp; 

tbp = tbp->nextbuf ; 



/* The stuff we need is not in a buffer, we must make a buffer */ 
/* available, and fill it with the desired track */ 

if (mtbp) mtbp->nextbuf = 0; /* detach lru buffer */ 

ltbp->nextbuf = firstbuf; 

firstbuf = ltbp; 

setimasM imsave) ; 

if (flushl(ltbp) S4 fill(ltbp)) mtbp = ltbp; /* success */ 

else mtbp = OL ; /* failure */ 

return (mtbp) ; 
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/* 

/*****• 

read() 
I 



Bios READ Function -- read one sector 



REG BYTE *p 

REG BYTE *q 

REG WORD i 

REG struct tbstr *tbp; 

tbp - gettrk(); /* locate track buffer with sector */ 

if ( ! tbp ) return(l); /* failure */ 

/* locate sector in buffer and copy contents to user area */ 

p = (tbp->buf) + (setsec << 7); /* multiply by shifting */ 

q = setdma; 

i = 128; 

do {*q++ = *p+ + ; i -= 1; } while (i); /* this generates good code */ 

return (0) ; 



/* 


BIOS 


WRITE 


Function 


- 


/*** 


******* 


******* 


******** 


** 


wr i te(mode) 








BYTE 
( 


mode; 








I 


REG 


BYTE 


*p; 






REG 


BYTE 


*q; 






REG 


WORD 


i; 






REG 


struct 


tbstr *t 


bp 



: ite one sector 



/* locate track buffer containing sector to be written */ 

tbp = gettrk() ; 

if ( ! tbp ) return (1); /* failure */ 

/* locate desired sector and do copy the data from the user area */ 

p = (tbp->buf) + (setsec << 7); /* multiply by shifting */ 

q = setdma; 

i = 128; 

do {*p++ = *q++; i -= 1; } while (i); /* this generates good code */ 

tbp->dirty = 1; /* the buffer is now "dirty" */ 

/* The track must be written if this is a directory write */ 

if ( mode == 1 ){if ( flushl(tbp) ) return(O); else return(l);) 
else return(O); 
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/* Read and Write functions for the Loader BIOS */ 



REG BYTE * p.- 
REG BYTE *q; 
REG KORD ij 

if ( ( (! bufvalid) || (buftrk != settrk) ) ii 

( ! dskxfer(setdsk, settrk, bufltrk, DSKREAD) ) ) { re turn (1) ; | 
bufvalid = 1; 
buftrk = settrk; 
p = bufltrk + (setsec << 7); 
q = setdma; 
i = 128; 

do { *q++ = *p+ + ; i- = l; } while(i); 
return (0) ; 



/* BIOS Sector Translate Function V 

WORD sectranfs, xp) 
REG WORD s; 
REG BYTE *xp; 

if (xp) return (WORD)xp(sl; 
else return (s+1) ; 

/* BIOS Set Exception Vector Function */ 

LONG setxvect(vnum, vval) 
WORD vnum; 
LONG vval; 
{ 

REG LONG oldval; 

REG BYTE *vloc; 

vloc = ( (long) vnum ) << 2; 
oldval = vloc->lword; 
vloc->lword = wal; 
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return (oldva 1) ; 



/* BIOS Select Disk Function */ 

LONG slctdsk(dsk, logged) 
REG BYTE dsk; 

BYTE logged ,- 

REG struct dph *dphp; 
REG BYTE Stl, St2; 

BYTE stpkt[STPKTSZ] ; 

setdsk = dsk; /* Record the selected disk number */ 

I if ! LOADER 

/* Special Code to disable drive C. On the EXORmacs, drive C */ 

/* is the non-removable hard disk. ' */ 

if ( (dsk > MAXDSK) || ( dsk == 2 ) ) 

printstr ("nrBIOS ERROR — DISK "); 
portout (PORT1, 'A'+dsk); 
printstr(" NOT SUPPORTEDnr") ; 
return(OL) ; 



dphp = &dphtab[dsk] ; 
if ( ! (logged s, Oxl) ) 

hmpack.dskno = cnvdsk[ setdsk] ; 

hmpack.coml = 0x30; 

hmpack.com2 = 0x0 2; 

actvdsk = dsk; 

dskstate[ dsk] .change = 0; 

sendpkt(&hmpack, 7); 

if ( ! dskwait(dsk, 0x72, 0x0) ) 

{ 

sendack ( ) ; 

ipc state = IDLE; 

return ( 0L ) ; 

} 

getstpkt(stpkt) ; /* determine disk type and size */ 

sendackf) ; 

ipcstate = IDLE; 

stl = stpkt[PKTSTPRH]; 

st2 = stpkt[PKTSTPRM + l]; 
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if ( stl & 0x80 ) /* not ready / ready */ 

dskstate [ dsk) . ready » 0; 
return(OL) ; 

else 

dskstate[ dsk] . ready = 1; 

switch ( stl {. 7 ) 

case 1 : /* floppy disk */ 

dphp->dpbp = SdpbO; 
break; 

case 2 : /* hard disk */ 



dphp->dpbp = &dpb2; 
break; 

bioserr ( "Invalid Disk Status"); 

dphp = 0L; 

break; 



re turn (dphp) ; 



I if ! LOADER 
/***..****.***,.,****,*.**.******,♦.*,..****.**.»*****.*****.*..*/ 

/* V 

/* This function is included as an undocumented, */ 

/*■ unsupported method for EXORmacs users to format */ 

/* disks. It is not a part of CP/M-68K proper, and */ 

/* is only included here for convenience, since the */ 

/* Motorola disk controller is somewhat complex to */ 

/* program, and the BIOS contains supporting routines. */ 

/* V 

/****..******.*....***********.**.***.*******..**..**.***.*******/ 

format(dsk) 
REG WORD dsk; 
{ 

REG WORD retval; 

if ( t slctdskf (BVTE)dsk, (BYTE) 1 ) ) return; 

f mtpack.dskno = cnvdsk[setdsk] ; 

actvdsk = setdsk; 

dskstate! setdsk] .change = 0; 

sendpkt(trfmtpack, 7); 

if ( 1 dskwait(setdsk, 0x70, 0x0) ) retval = 0; 

else retval = 1; 



Listing D-l. (continued) 



89 



CP/M-68K System Guide D EXORmacs BIOS 



sendack () ; 
ipcstate = IDLE; 
return! retval) ; 



/* V 

/* Bios initialization. Must be done before any regular BIOS */ 

/* calls are performed. */ 

/* V 



biosin it( ) 



initprtsf) ; 
initdsks() ; 



nitprts( ) 



Jelse 
fendif 



portinit(PORTl) ; 
portinit(P0RT2) ; 



REG WORD i; 

REG WORD imsave; 

LOADER 

for ( i = 0; i < NUMTB; ++i ) 

tbuf[i] .valid = 0; 

tbuf [i] .dirty = 0; 

if ( (i+1) < NUMTB ) tbuf [i] .nextbuf = &tbuf[i+l]; 

else tbuf [ i] .nextbuf = 0; 

f irstbuf = stbuf [0] ; 
lastbuf = & tbuf [NUMTB-1]; 

bufvalid = 0; 



for ( i - 0; i <= MAXDSK; i += 1) 

dskstatet i] .state = IDLE; 
dskstatejij . ready = 1; 
dskstatet i] .change = 0; 

imsave = setimask(7); /* turn off interrupts */ 
intcount = 0; 
ipcstate = IDLE; 
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setimask { imsave) ; /* turn on interrupts */ 



LONG cbios(dO, dl, d2) 
REG WORD dO; 

REG LONG dl, d2; 

{ 



BIOS MAIN ENTRY — Branch out to the various functions. 



switch (dO ) 



#if ! LOADER 



case 0: biosinit ( ) ; 
break; 



case 1: flush(); 

initdsksf) ; 
wboot( ) ; 
/* break; */ 



/* KBOOT 



case 


2: 
/* 


return(por tstat(PORTl) ) ; 
break; */ 


/* 


CONST 


V 


case 


3: 
/* 


return (por tin (PORT1) ) ; 
break; */ 


/* 


CONIN 


V 


case 


4: 


por tout(PORTl, (char)dl); 
break; 


/* 


CONOUT 


V 


case 
case 


5: 

6: 


portout (PORT2, (char)dl); 
break; 


/* 
/* 


LIST 
PUNCH 


V 
V 


case 


7: 
/* 


r e turn (por tin (P0RT2)) ; 
break; */ 


/* 


READER 


V 


case 


8: 


settrk = 0; 
break; 


/* 


HOME 


V 


case 


9: 
/* 


return (slctdsk ( (char) dl , 
break; */ 


(Char)d2)) ; /* SELDSK 


V 


case 


10 


: settrk = (int)dl; 
break; 


/* 


SETTRK 


V 


case 


11 


: setsec = ((int)dl-l) ; 


/* 


SETSEC 


V 



break; 
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lit ! LOADER 



case 12: setdma » dl; 
break; 

case 13: re turn ( read( ) ) ; 
/* break; */ 

case 14: re turn (wr ite ( (char) dl )) ; 
/* break; */ 

case 15: if ( * (BYTE *)(PORT2 + PORTSTAT) S. PORTTDRE ) 
return ( OxOf f ) ; 
else return ( 0x000 ); 
/* break; */ 



/* SETDMA 


V 


/* READ 


V 


/* WRITE 


*/ 



I if ! LOADER 



I end if 

t if ! LOADER 



case 16: return ( sec tranl ( in t) dl , d2)); /* SECTRAN 
/* break; */ 



case 18: return (smemtab) ; 
/* break; */ 

case 19: return ( iobyte) ; 
/* break; */ 

case 20: iobyte = (int)dl; 
break; 

case 21: if (flush()) return(OL); 

else return(OxffffL) : 

/* break; */ 



case 22: return (setxvect( ( in t) dl ,d2) ) ; /* SETXVECT 
/* break; */ 



/* SECTRAN 


V 


/* GMRTA 


V 


/* GETIOB 


V 


/* SETIOB 


V 


/* FLUSH 


V 



This function is not part of a standard BIOS. 
It is included only for convenience, and will 
not be supported in any way, nor will it 
necessarily be included in future versions of 
CP/M-68K 



tend if 



case 63: return! ! format( ( int) dl) ); /* Disk Formatter 
/* break; */ 



default: return(OL); 
break; 



) /* end switch */ 
} /* END OF BIOS */ 
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/* End of C Bios */ 



NORMBIOS.H 

This should be renamed "BIOSTYPE.H" if you are compiling a 
normal BIOS. 



Idefine LOADER 
♦define CTLTYPE 



LOADBIOS.H 

This should be renamed "BIOSTYPE.H" if you are compiling a 
loader BIOS. 



Idefine LOADER 1 
tdefine CTLTYPE 



BIOSA.H 
This is the assembly language interface needed by the normal 
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.globl 


_init 




.globl 


biosinit 




.globl 


_flush 




.globl 


_wboot 




.globl 


_cbios 




.globl 


_dskia 




.globl 


_dskic 




.globl 


_setimask 




.globl 


_ccp 


in it : 


lea 


entry t a0 




move.l 


aO,$8C 




lea 


dskia, aO 




move.l 


a0,$3fc 




move 


*$2000,sr 




jsr 


biosinit 




clr.l 


dO 




rts 




wboot: 


clr.l 


dO 




jmp 


_ccp 


;ntry : 


move. 1 


d2,-(a7) 




move. 1 


dl,-(a7) 




move. w 


d0,-(a7) 




jsr 


cbios 




add 


#10,a7 




rte 




dskia : 


link 


a6,t0 




movem. 1 


d0-d7/a0-a5,-(a7) 




jsr 


dskic 




movem. 1 


(a7)+,d0-d7/a0-a5 




unlk 


a6 




rte 




setima 


iSk: move 


sr ,d0 




lsr 


18, dO 




and. 1 


#7,d0 




move 


sr.dl 




ror . w 


#8,dl 




and.w 


#$fff8,dl 




add. w 


4(a7),dl 




ror. w 


»8,dl 




move 


dl,sr 




rts 
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LDBIOSA.S 
This is the assembly language interface used by the loader 



.text 

.globl _bios 



.globl _biosinit 

.globl _cbios 

.globl _dskia 

.globl _dskic 

.globl _setimask 



link 




a6,IO 


move. 


1 


d2,-(a7) 


move. 


,1 


dl,-(a7) 


move. 


VI 


d0,-(a7) 


move 




»$2000,sr 


lea 




dskia.aO 


move. 


,1 


a0,$3fc 


jsr 




cbios 


unlk 




a6 


rts 







dskia: link a6,#0 

movem. 1 d0-d7/a0-a5 # -(a7) 

jsr _dskic 

movem. 1 (a7 )+, d0-d7/a0-a5 

unlk a6 

rte 

setimask: move sc,dO 

lsr #8,d0 

and.l »7,d0 

move sr,dl 

ror.w tB,dl 

and.w #$f£f8,dl 

add.w 4(a7),dl 

ror.w 18, dl 

move dl,sr 
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BIOSTYPS.H 
These type definitions are needed by the C BIOS. 



/* V 

/* Portable type definitions for use */ 

/* with the C BIOS according to */ 

/• CP/M-68K (tm) standard usage. */ 

/* V 

/..*.....,..,.*.*...*..*.*..........*.*..***«..../ 

I define LONG long 

Idefine ULONG unsigned long 

idefine WORD short int 

tdefine UWORD unsigned short 

Idefine BYTE char 

Idefine UBYTE unsigned char 

Idefine VOID 

Idefine REG register 

Idefine LOCAL auto 

Idefine MLOCAL static 

Idefine GLOBAL extern 

Idefine EXTERN extern 
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CP/M 68000 Assembler Revision 02.01 Page 

Source File: putboot. s 



Program to Write Boot Tracks for CP/M-68K (tm) 
Copyright Digital Research 1982 



13 






14 






15 






16 






17 






18 






19 






20 






21 






22 






23 






24 






25 






26 






27 






28 


00000000 




29 






30 


00000000 


4E560000 


31 


00000004 


206E0008 


32 


00000008 


43E8005C 


33 


oooooooc 


23C900004080 


34 


00000012 


423900004094 


35 


00000018 


D0FC0O81 


36 


0000001C 


0C180020 


37 


00000020 


67FA 


38 


00000022 


5388 


39 


00000024 


4A10 


40 


00000026 


670001A4 


41 


0000002A 


OC18002D 


42 


0000002E 


66 26 



prn tstr 


= 


9 


BDOS Functions 


dseldsk 


= 


14 




open 


= 


15 




readseq 


= 


20 




dsetdma 


= 


26 




seldsk 


= 


9 


BIOS Functions 


settrk 


= 


10 




set sec 


= 


11 




isetdma 


= 


12 




write 


= 


14 




sec tran 


=. 


16 




flush 


= 


21 




bufcn t 


= 


$80 




bufsize 


= 


$80*t 


lufcnt 



link 


a6,t0 




move. 1 


8 (a6) ,a0 


base page address 


lea 


$5c(a0) ,al 




move. 1 


al,fcb 




clr.b 


hflag 




add 


I$81,a0 


first character of command tail 


cmpi. b 


t$20, (a0) + 


skip over blanks 


beq 


scan 




sub. 1 


11, aO 




tst. b 


(aO) 




beq 


erxit 




cmpi. b 


»$2d, (a0) + 


check for -H flag 


bne 


nohyph 
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43 00000030 0C180048 

44 00000034 66000196 

45 00000038 4A3900004094 

46 0000003E 6600018C 

47 00000042 13FCOOFF00004094 

48 0000004A 04B90000002400004080 

49 00000054 60C6 

50 00000056 0C100020 

51 0000005A 66C8 

52 0000005C 0C180020 

53 00000060 67FA 

54 00000062 0C200061 

55 00000066 6D04 

CP/M 68000 Assemb] 
Source File: putboot. s 



cmpi. b 



nohyph: 



56 



00000068 04500020 
0000006C OC100041 
00000070 6D00015A 
00000074 OC100050 
00000078 6E000152 
0000007C 1010 
0000007E 4880 
00000080 907C0041 
00000084 33C00000408A 



bne 
tst.b 
bne 

move. b 
sub. 1 
bca 

cmpi. b 
bne 

cmpi. b 
beq 

cmpi. b 
bit 



|$48, (a0) + 

erxit 

hflag 

erxit 

t$ff, hflag 

l$24,fcb 

scan 
b |$20,(a0) 

scanl 
b t$20,(a0) + 

scan 2 
b I$61,-(a0) 

upper 
Revision 02.01 



sub 

cmpi. b 
bit 

cmpi. b 
bgt 

move. b 
ext. w 
sub. w 
move. w 



l$20, (aO) 

IS41,(aO) 

erxit 

t$50,(a0) 

erxit 

(aO) ,d0 

dO 

#$41, dO 

d0,dsk 



change to 2nd default fcb 



get disk letter 
upshift 

Page 2 



with range A 



put disk letter into range 0-15 



open file to copy 



0000008A 303C000F 
0000008E 223900004080 
00000094 4E42 
00000096 OC4000FF 
0000009A 660C 
0000009C 223C00000034 
00O00OA2 4EF9000001D2 
00O000A8 207900004080 
O0O0O0AE 42280020 



openok : 



move. w 
move. 1 
trap 
c mp i . w 
bne 

move. 1 
jmp 

move. 1 
clr.b 



topen,d0 

fcb,dl 

12 

t$00ff,d0 

openok 

topnf l,dl 

erx 

fcb.aO 

32 (aO) 



000000B2 243COOO0O0OO 
000000B8 42790000408E 
000000BE 303C001A 
000000C2 2202 
O0O000C4 4E42 
00000OC6 303C0014 
000000CA 223900004080 
000000D0 4E42 
000000D2 4A40 
000000D4 661A 
OOO00OD6 D4BC00000080 
000000DC 52790000408E 
O0O00OE2 0C7900800000408E 
O0000OEA 6EOO0OFE 
O0OO0OEE 60CE 



read 

move. 1 

clr.w 

move. w 

move. 1 

trap 

move. w 

move. 1 

trap 

tst.w 

bne 

add.l 

add.w 

cmpi. w 

bgt 

bra 



|buf,d2 

count 

#dsetdma,d0 

d2,dl 

12 

t readseq,d0 

fcb,dl 

12 

dO 

wrtout 

1128, d2 

1 1, count 

I bufcnt, count 

bufof lx 

r loop 
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95 « 

96 » 

97 * 

98 OO0O00F0 3O3CO0O9 wrtout 

99 OO0000F4 32390000408A 

100 000000FA 4202 

101 00OO00FC 4E43 

102 OOOOOOFE 4A80 

103 00000100 670000D8 

104 00000104 2040 

105 00000106 2068000E 

106 0000010A 33DOO00O4O84 

107 00000110 33E8000E0000408C 

108 00000118 427900004088 

109 000O011E 33FC000100004086 

110 00000126 41F9O0O0O000 

CP/M 68000 Assembler 
Source File: putboot. s 

111 0000012C 4A3900004094 

112 00000132 660C 

113 00000134 OC50601A 

114 00000138 6606 

115 0000013A D1FC00O0OO1C 

116 00000140 23C80000J090 wrtl: 

117 * 

118 00000146 4A790000408E wloop: 

119 0000014C 6774 

120 0000014E 323900004086 move.u 

121 00000154 B27900004084 

122 0000OL5A 6F1E 

123 0000015C 33FC000100004086 

124 00000164 303900004088 

125 0000016A 5240 

126 0000016C 33C000004088 

127 00000172 B0790000408C 

128 00000178 6C78 

129 0000017A 3O3C00OA sok: 

130 0000017E 323900004088 

131 00000134 4E43 

132 00000186 323900004086 

133 0000013C 3O3CO0OB 

134 00000190 4E43 

135 00000192 3O3C00OC 

136 00000196 223900004090 

137 0000019C 4E43 

138 0000019E 303C00OE 

139 000001A2 4241 

140 000001A4 4E43 

141 000001A6 4A40 

142 000001A8 6638 

143 000001AA 527900004086 

144 000001BO 53790000408E 

145 000001B6 06B90000008000004090 

146 000OO1C0 6084 



move. w 


Iseldsk.dO 


select the disk 


move.w 


dsk.dl 




clr.b 


d2 




trap 


13 




tst. 1 


dO 


check for select error 


beq 


selerx 




move. 1 


d0,a0 




move. 1 


14(a0),a0 


get DPB address 


move.w 


(aO) ,spt 


get sectors per track 


move. w 


14{a0),off 


get offset 


clr.w 


trk 


start at trk 


move.w 


ll.sect 


start at sector 1 


lea 


buf ,a0 




Revision 02.01 


Page 3 


tst.b 


hflag 




bne 


wrtl 




crapi . w 


l$601a, (aO) 




bne 


wrtl 




add. 1 


128, aO 




move.l 


aO, bufp 




tst.w 


count 




beq 


exit 




sect.dl 


check 


for end-of-track 


cmp. w 


spt,dl 




ble 


sok 




move. w 


11, sect 


advance to new track 


move.w 


trk.dO 




add.w 


»l,d0 




move.w 


dO, trk 




cmp. w 


off.dO 




bge 


oflex 




move.w 


lsettrk,d0 


set the track 


move.w 


trk,dl 




trap 


13 




move.w 


sect, dl 


set sector 


move. w 


I setsec.dO 




trap 


t3 




move. w 


1 i se td ma , dO 


set up dma address for i 


move. 1 


bufp,dl 




trap 


13 




move. w 


Iwr ite.dO 


and write 


clr.w 


dl 




trap 


13 




tst.w 


dO 


check for write error 


bne 


wr terx 




add 


»l,sect 


increment sector number 


sub 


»1, count 




add. 1 


1128, bufp 




bra 


wloop 
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147 

148 000001C2 303C0015 

149 000001C6 4E43 

150 000001C8 4E5E 

151 000001CA 4E75 
15 2 

153 000001CC 223C0000000O 

154 000001D2 303C0009 

155 000001D6 4E42 

156 000001D8 60E8 
157 

158 000001DA 223C00000017 

159 000001EO 6OF0 

160 000001E2 223C00000026 

161 000001E8 60E8 

162 000001EA 223C0000004E 

163 000001FO 60EO 

164 000001F2 223C00000060 

165 000001F8 60D8 
CP/M 68000 Ass 
Source File: putboot.s 



166 




167 




168 00000000 




169 




17 




171 




172 00000000 




17 3 




174 00004080 




175 00004084 




176 00004086 




177 00004088 




178 0000408A 




179 0000408C 




180 0000408E 




181 00004090 




182 00004094 




183 




184 00004096 




184 00000000 




18 5 




186 00000000 


496E76616C696420 


186 00000008 


436F6D6D616E6420 


186 00000010 


4C696E650D0A24 


187 00000017 


53656C6563742045 


187 0000001F 


72726F720D0A24 


188 00000026 


5772697465204572 


188 0000002E 


726F720D0A24 


189 00000034 


43616E6E6F74204F 


189 0000003C 


70656E20536F7572 


189 00000044 


63652046696C650D 


189 0000004C 


0A24 


190 0000004E 


427566666572204F 



exit: 


move. 


w 


» flush, dO 




trap 




t3 




unlk 




a6 




rts 






* 








erxit: 


move. 


1 


terstr , dl 


erx: 


move. 


,w 


tprntstr,d0 




trap 




#2 




bra 




exit 



selerx: move.l fselstr.dl 

bra erx 

wrterx: move.l |wrtstr,dl 

bra erx 

bufoflx: move.l tbufofl,dl 

bra erx 

oflex: move.l #trkofl,dl 

bra erx 

1 e r Revision 2.01 



exit location - flush bios buffers 



and exit to CCP 



miscellaneous errors 

print error message and exit 



disk select error 
disk write error 
buffer overflow 



buf: 


.ds. 


b 


bufsiz 


e+128 




fcb: 


.ds. 


1 


1 




fcb address 


spt: 


.ds. 


w 


1 




sectors per track 


sect: 


.ds. 


w 


1 




current sector 


trk: 


.ds. 


, w 


1 




current track 


dsk: 


.ds. 


, w 


1 




selected disk 


off: 


.ds. 


. w 


1 




1st track of non-boot area 


count: 


.ds. 


, w 


1 






bufp: 


.ds. 


,1 


1 






hflag: 


.ds. 


.b 


1 







erstr: .dc.b 'Invalid Command Line' ,13, 10, ' 5' 

selstr: .dc.b 'Select Er ror ' , 13,10, ' 5' 

wrtstr: .dc.b 'Write Error ' ,13, 10, ' $' 

opnfl: .dc.b 'Cannot Open Source File ' ,13, 10, ' $' 

bufofl: .dc.b 'Buffer Overflow' ,13, 10 ,' 5' 
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190 00000056 766572666C6F770D 

190 0000005E 0A24 

191 00000060 546F6F204D756368 trkofl: .dc.b 'Too Much Data for System Tracks' , 13 , 10, ' $' 
191 00000068 204461746120666F 

191 00000070 722053797374656D 

191 00000078 20547261636D730D 

191 00000080 0A24 

19 2 * 

19 3 * 

194 00000082 .end 

CP/M 68000 Assembler Revision 02.01 Page 5 

Source File: putboot.s 

Symbol Table 

0000004E DATA bufoflx 000001EA TEXT 

OO0O408E BSS 

00000000 DATA 

00004080 BSS 

00000056 TEXT 

000000A8 TEXT 

OOO0O0BE TEXT 

00004086 BSS 

00000017 DATA 

00004084 BSS 

0000006C TEXT 

000001E2 TEXT 



buf 


00000000 


BSS 


bufcnt 


00000080 


ABS 


bufofl 


bufp 


00004090 


BSS 


bufsize 


00004000 


ABS 


count 


dse tdma 


0000001A 


ABS 


dsk 


0000408A 


BSS 


erstr e 


erxit 


000001CC 


TEXT 


ex it 


000001C2 


TEXT 


fcb 


hflag 


00004094 


BSS 


isetdma 


OOOOOOOC 


ABS 


nohyph 


of lex 


000001F2 


TEXT 


open 


000O0O0F 


ABS 


openok 


prn tstr 


00000009 


ABS 


readseq 


00000014 


ABS 


r loop 


scanl 


00000024 


TEXT 


scan2 


0000005C 


TEXT 


sect 


seldsk 


00000009 


ABS 


se le rx 


000001DA 


TEXT 


selstr 


settrk 


0000000A 


ABS 


sok 


0000017A 


TEXT 


spt 


trk 


00004088 


BSS 


trkofl 


00000060 


DATA 


upper 


wr i te 


0O0O000E 


ABS 


wrtl 


00000140 


TEXT 


wr terx 


wrtstr 


00000026 


DATA 











dseldsk 


0OOOO00E 


ABS 


erx 


000001D2 


TEXT 


flush 


00000015 


ABS 


off 


0000408C 


BSS 


opnfl 


00000034 


DATA 


scan 


OOOOOOIC 


TEXT 


sec tran 


00000010 


ABS 


se tsec 


0O00OOOB 


ABS 


start 


00000000 


TEXT 


wloop 


00000146 


TEXT 


wr tout 


OOOOOOFO 


TEXT 



Listing E-l. (continued) 

End of Appendix E 
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Motorola S-Records 



F.l S-record Format 

The Motorola S-record format is a method of representing 
binary memory images in an ASCII form. The primary use of S-records 
is to provide a convenient form for transporting programs between 
computers. Since most computers have means of reading and writing 
ASCII information, the format is widely applicable. The SENDC68 
utility provided with CP/M-68K may be used to convert programs into 
S-record form. 

An S-record file consists of a sequence of S-records of 
various types. The entire content of an S-record is ASCII. When a 
hexadecimal number needs to be represented in an S-record it is 
represented by the ASCII characters for the hexadecimal digits 
comprising the number. Each S-record contains five fields as 
follows: 



Field: 
Characters: 



s 


type 


length 


address 


data 


checksum 



2, 4 or 6 variable 



Figure F-l. S-record Fields 



The field contents are as follows 



Table F-l. S-record Field Contents 



Field 


Contents 


S 
type 


The, ASCII Character 'S 1 . This signals 
the beginning of the S-record. 

A digit, between and 9, represented in 
ASCII, with the exceptions that 4 and 6 
are not allowed. Type is explained in 
detail below. 
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F.l S-record Format 



Table F-l. (continued) 



Field 



Contents 



length 



address 



data 



checksum 



The number of character pairs in the 
record, excluding the first three 
fields. (That is, one half the number 
of characters total in the address, 
data, and checksum fields. ) This field 
has two hexadecimal digits, representing 
a one byte quantity. 

The address at which the data portion of 
the record is to reside in memory. The 
data goes at this address and 
successively higher numbered addresses. 
The length of this field is determined 
by the record type. 

The actual data to be loaded into memory, 
with each byte of data represented as a 
pair of hexadecimal digits, in ASCII. 

A checksum computed over the length, 
address, and data fields. The checksum 
is computed by adding the values of all 
the character pairs (each character pair 
represents a one-byte quantity) in these 
fields, taking the one's complement of 
the result, and finally taking the least 
significant byte. This byte is then 
represented as two ASCII hexadecimal 
digits. 



F.2 S-record Types 

There are eight types of S-records. They can be divided into 
two categories: records containing actual data, and records used to 
define and delimit groups of data -containing records. Types 1, 2, 
and 3 are in the first category, and the rest of the types are in 
the second category. Each of the S-record types is described 
individually below. 
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Table F-2. S-record Types 



Type 



Meaning 



This type is a header record used at the beginning 
of a group of S-records. The data field may 
contain any desired identifying information. The 
address field is two bytes (four S-record 
characters) long, and is normally zero. 

This type of record contains normal data. The 
address field is two bytes long (four S-record 
characters) . 

Similar to Type 1, but with a 3-byte (six S-record 
characters) address field. 

Similar to Type 1, but with a 4-byte (eight S- 
record characters) address field. 

This record type indicates the number of Type 1, 
2, and 3 records in a group of S-records. The 
count is placed in the address field. The data 
field is empty (no characters) . 

This record signals the end of a block of type 3 
S-records. If desired, the address field is 4 
bytes long (8 characters) , and may be used to 
contain an address to which to pass control. The 
data field is empty. 

This is similar to type 7 except that it ends a 
block of type 2 S-records, and its address field 
is 3 bytes (6 characters) long. 

This is similar to type 7 except that it ends a 
block of type 1 S-records, and its address field 
is 2 bytes (4 characters) long. 



S-records are produced by the SENDC68 utility program 
(described in the CP/M-68K Operating System Programmer's Guide) . 



End of Appendix F 



10 5 



Appendix G 
CP/M-68K Error Messages 



This appendix lists the error messages returned by the internal 
components of CP/M-68K: BDOS, BIOS, and CCP, and by the CP/M-68K 
system utility, PUTBOOT. The BIOS error messages listed here are 
specific to the EXORmacs BIOS distributed by Digital Research. 
BlOSes for other hardware might have different error messages which 
should be documented by the hardware vendor. 

The error messages are listed in Table G-l in alphabetic order 
with explanations and suggested user responses. 

Table G-l. CP/M-68K Error Messages 



Message Meaning 



bad relocation information bits 

CCP. This message is a result of a BDOS 
Program Load Function (59) error. It indicates 
that the file specified in the command line is 
not a valid executable command file, or that 
the file has been corrupted. Ensure that the 
file is a command file. The CP/M-68K Operating 
System Programmer' s Guide describes the format 
of a command file. If the file has been 
corrupted, reassemble or recompile the source 
file, and relink it before you reenter the 
command line. 



BIOS ERROR — DISK X NOT SUPPORTED 

BIOS. The disk drive indicated by the variable 
•-'X" is not supported by the BIOS. The BDOS 
supports a maximum of 16 drives, lettered A 
through P. Check the documentation provided by 
the manufacturer for your particular system 
configuration to find out which of the BDOS 
drives your BIOS implements. Specify the 
correct drive code and reenter the command 
line. 
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Table G-l. (continued) 



Message Meaning 



BIOS ERROR — Invalid Disk Status 

BIOS. The disk controller returned unexpected 
or incomprehensible information to the BIOS. 
Retry the operation. If the error persists, 
check the hardware. If the error does not come 
from the hardware, it is caused by an error in 
the internal logic of the BIOS. Contact the 
place you purchased your system for assistance. 
You should provide the information below. 

1) Indicate which version of the operating 
system you are using. 

2) Describe your system's hardware 
configuration. 

3) Provide sufficient information to reproduce 
the error. Indicate which program was 
running at the time the error occurred. If 
possible, you should also provide a disk 
with a copy of the program. 



Buffer Overflow 



PUTBOOT. The bootstrap file will not fit in 
the PUTBOOT bootstrap buffer. PUTBOOT contains 
an internal buffer of approximately 16K bytes 
into which it reads the bootstrap file. Either 
make the bootstrap file smaller so that it will 
fit into the buffer, or change the size of the 
PUTBOOT buffer. The PUTBOOT source code is 
supplied with the system distributed by DRI . 
Equate bufsize (located near the front of the 
PUTBOOT source code) to the required dimension 
in Hexidecimals. Reassemble and relink the 
source code before you reenter the PUTBOOT 
command line. 



Cannot Open Source File 



PUTBOOT. PUTBOOT cannot locate the source 
file. Ensure that you specify the correct 
drive code and filename before you reenter the 
PUTBOOT command line. 
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Table G-l. (continued) 



Message Meaning 



CP/M Disk change error on drive x 

BDOS. The disk in the drive indicated by the 
variable x is not the same disk the system 
logged in previously. When the disk was 
replaced you did not enter a CTRL-C to log in 
the current disk. Therefore, when you 
attempted to write to, erase, or rename a file 
on the current disk, the BDOS set the drive 
status to read-only and warm booted the system. 
The current disk in the drive was not 
overwritten. The drive status was returned to 
read-write when the system was warm booted. 
Each time a disk is changed, you must type a 
CTRL-C to log in the new disk. 



CP/M Disk file error: filename is read-only. 
Do you want to: Change it to read/write (C) , 
or Abort (A)? 

BDOS. You attempted to write to, erase, or 
rename a file whose status is read-only. 
Specify one of the options enclosed in 
parentheses. If you specify the C option, the 
BDOS changes the status of the file to read- 
write and continues the operation. The read- 
only protection previously assigned to the file 
is lost. 

If you specify the A option or a CTRL-C, 
the program terminates and CPM-68K returns the 
system prompt. 



CP/M Disk read error on drive x 

Do you want to: Abort (A), Retry (R) , or Continue 
with bad data (C) ? 

BDOS. This message indicates a hardware error. 
Specify one of the options enclosed in 
parentheses. Each option is described below. 

Option Action 

A or CTRL-C Terminates the operation and 
CP/M-68K returns the system 
prompt. (Meaning continued on 
next page.) 
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Table G-l. (continued) 



Message Meaning 



CP/M Disk read error on drive x (continued) 

Option Action 

R Retries operation. If the retry 

fails, the system reprompts with 
the option message. 

C Ignores error and continues 

program execution. Be careful 
if you use this option. Program 
execution should not be 
continued for some types of 
programs. For example, if you 
are updating a data base and 
receive this error but continue 
program execution, you can 
corrupt the index fields and the 
entire data base. For other 
programs, continuing program 
execution is recommended. For 
example, when you transfer a 
long text file and receive an 
error because one sector is bad, 
you can continue transferring 
the file. After the file is 
transferred, review the file, 
and add the data that was not 
transferred due to the bad 
sector . 



CP/M Disk write error on drive x 

Do you want to: Abort (A), Retry (R) , 

or Continue with bad data (C)? 

BDOS. This message indicates a hardware error. 
Specify one of the options enclosed in 
parentheses. Each option is described below. 

Option Action 

A or CTRL-C Terminates the operation and 
CP/M-68K returns the system 
prompt. 

R Retries operation. If the retry 

fails, the system reprompts with 
the option message (Meaning 
continued on next page.) 
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Table G-l. (continued) 



Message Meaning 



CP/M Disk write error on drive x (continued) 

Option Action 

C Ignores error and continues 

program execution. Be careful 
if you use this option. Program 
execution should not be 
continued for some types of 
programs. For example, if you 
are updating a data base and 
receive this error but continue 
program execution, you can 
corrupt the index fields and the 
entire data base. For other 
programs, continuing program 
execution is recommended. For 
example, when you transfer a 
long text file and receive an 
error because one sector is bad, 
you can continue transferring 
the file. After the file is 
transferred, review the file, 
and add the data that was not 
transferred due to the bad 
sector. 



CP/M Disk select error on drive x 

Do you want to: Abort (A), Retry (R) 

BDOS . There is no disk in the drive or the 
disk is not inserted correctly. Ensure that 
the disk is securely inserted in the drive. If 
you enter the R option, the system retries the 
operation. If you enter the A option or CTRL-C 
the program terminates and CPM-68K returns the 
system prompt. 



CP/M Disk select error on drive x 

BDOS. The disk selected in the command line is 
outside the range A through P. CP/M-68K can 
support up to 16 drives, lettered A through P. 
Check the documentation provided by the 
manufacturer to find out which drives your 
particular system configuration supports. 
Specify the correct drive code and reenter the 
command line. 
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Table G-l. (continued) 



Message Meaning 



File already exists 



CCP. This error occurs during a REN command. 
The name specified in the command line as the 
new filename already exists. Use the ERA 
command to delete the existing file if you wish 
to replace it with the new file. If not, 
select another filename and reenter the REN 
command line. 



insufficient memory or bad file header 

CCP. This error could result from one of three 
causes: 

1) The file is not a valid executable command 
file. Ensure that you are requesting the 
correct file. This error can occur when you 
enter the filename before you enter the 
command for a utility. Check the 
appropriate section of the CP/M-68K 
Operating System Programmer's Guide or the 
CP/M-68K Operating System User's Guide for 
the correct command syntax before you 
reenter the command line. If you are trying 
to run a program when this error occurs, the 
program file may have been corrupted. 
Reassemble or recompile the source file and 
relink it before you reenter the command 
line. 

2) The program is too large for the available 
memory. Add more memory boards to the 
system configuration, or rewrite the program 
to use less memory. 

3) The program is linked to an absolute 
location in memory that cannot be used. The 
program must be made relocatable, or linked 
to a usable memory location. The BDOS 
Get/Set TPA Limits Function (6 3) returns the 
high and low boundaries of the memory space 
that is available for loading programs. 
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Table G-l. (continued) 



Message Meaning 



Invalid Command Line 



PUTBOOT. Either the command line syntax is 
incorrect, or you have selected a disk drive 
code outside the range A through P. Refer to 
the section in this manual on the PUTBOOT 
utility for a full description of the command 
line syntax. The CP/M-68K BDOS supports 16 
drives, lettered A through P. The BIOS may or 
may not support all 16 drives. Check the 
documentation provided by the manufacturer for 
your particular system configuration to find 
out which drives your BIOS supports. Specify a 
valid drive code before reentering the PUTBOOT 
command line. 



No file 



CCP. The filename specified in the command 
line does not exist. Ensure that you use the 
correct filename and reenter the command line. 



No wildcard filenames 



CCP. The command specified in the command line 
does not accept wildcards in file 
specifications. Retype the command line using 
a specific filename. 



Program Load Error 



CCP. This message indicates an undefined 
failure of the BDOS Program Load Function (59). 
Reboot the system and try again. If the error 
persists, then it is caused by an error in the 
internal logic of the BDOS. Contact the place 
you purchased your system for assistance. You 
should provide the information below. 

1) Indicate which version of the operating 
system you are using. 

2) Describe your system's hardware configur- 
ation. (Meaning continued on next page.) 
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Table G-l. (continued) 



Message Meaning 



3) Provide sufficient information to reproduce 
the error. Indicate which program was 
running at the time the error occurred. If 
possible, you should also provide a disk 
with a copy of the program. 



read error on program load 



CCP. This message indicates a premature end- 
of-file. The file is smaller than the header 
information indicates. Either the file header 
has been corrupted or the file was only 
partially written. Reassemble or recompile the 
source file, and relink it before you reenter 
the command line. 



Select Error 



PUTBOOT. This error is returned from the BIOS 
select disk function. The drive specified in 
the command line is either not supported by the 
BIOS, or is not physically accessible. Check 
the documentation provided by the manufacturer 
to find out which drives your BIOS supports. 
This error is also returned if a BIOS supported 
drive is not supported by your system 
configuration. Specify a valid drive and 
reenter the PUTBOOT command line. 



SUB file not found 



CCP. The file requested either does not exist, 
or does not have a filetype of SUB. Ensure 
that you are requesting the correct file. 
Refer to the section on SUBMIT in the CP/M-68K 
Operating System User's Guide for information 
on creating and using submit files. 



Syntax: REN newf ile=oldf ile 



CCP. The syntax of the REN command line is 
incorrect. The correct syntax is given in the 
error message. Enter the REN command followed 
by a space, then the new filename, followed 
immediately by an equals sign (=) and the name 
of the file you want to rename. 
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Table G-l. (continued) 



Message Meaning 



Too many arguments: argument? 

CCP. The command line contains too many 
arguments. The extraneous arguments are 
indicated by the variable argument. Refer to 
the CP/M-68K Operating System User's Guide for 
the correct syntax for the command. Specify 
only as many arguments as the command syntax 
allows and reenter the command line. Use a 
second command line for the remaining 
arguments, if appropriate. 



Too Much Data for System Tracks 

PUTBOOT. The bootstrap file is too large for 
the space reserved for it on the disk. Either 
make the bootstrap file smaller, or redefine 
the number of tracks reserved on the disk for 
the file. The number of tracks reserved for 
the bootstrap file is controlled by the OFF 
parameter in the disk parameter block in the 
BIOS. 

This error can also be caused by a 
bootstrap file that contains a symbol table and 
relocation bits. To find out if the bootstrap 
program will fit on the system tracks without 
the symbol table and relocation bits, use the 
SIZE68 Utility to display the amount of space 
the bootstrap program occupies. The first and 
second items returned by the SIZE68 Utility are 
the amount of space occupied by the text and 
data, respectively. The third item returned is 
the amount of space occupied by the BSS . The 
sum of the first two items, or the total minus 
the third item, will give you the amount of 
space required for the bootstrap program on the 
system tracks. Compare the amount of space 
your bootstrap program requires to the amount 
of space allocated by the OFF parameter. 

Because the symbol table and relocation 
bits are at the end of the file, the bootstrap 
program may have been entirely written to the 
system tracks and you can ignore this message. 
Or, you can run RELOC on the bootstrap file to 
remove the symbol table and relocation bits 
from the bootstrap file and reenter the PUTBOOT 
command line. 
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Table G-l. (continued) 



Message Meaning 



User # range is [0-15] 



CCP. The user number specified in the command 
line is not supported by the BIOS. The valid 
range is enclosed in the square brackets in the 
error message. Specify a user number between 
and 15 (decimal) when you reenter the command 
line. 



Write Error 



PUTBOOT. Either the disk to which PUTBOOT is 
writing is damaged or there is a hardware 
error. Insert a new disk and reenter the 
PUTBOOT command line. If the error persists, 
check for a hardware error. 



End of Appendix G 
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Reader Comment Card 

We welcome your comments and suggestions. They help us provide you with better 
product documentation. 

Date First Edition: January 1983 
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2. What suggestions do you have for improving this manual? What information 
is missing or incomplete? Where are examples needed? 



3. Did you find errors in this manual? (Specify section and page number.) 
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/*•**'*♦*** v 

/ . v 

/* Define the two serial potts on the DEDUG board •/ 

/............................. .............../ 

/• Port Addresses «/ 

Idefine P0RT1 OxFFEEOll /* console port */ 
Ideflne PORT2 OxFFF.EOlS /* debug port */ 

/• Port Offsets V 

Ideflne PORTCTRL /* Control Register V 

Ideflne rORTSTAT /* Status Register V 

Ideflne PORTRDR 2 /* Read Data Register V 

Ideflne roRTTDR 2 /* Write Data Register */ 

/* Tort Control Functions V 

Ideflne PORTRSET 3 /* Port Reset •/ 

Ideflne PORTIHIT Oxll /* Port Initialize •/ 

/* Port Status Values •/ 

Ideflne PORTRDRF 1 /• Read Data Register Full ♦/ 

Ideflne rORTTDRE 2 /* Write Data Register Empty •/ 

/* ****** * ../ 

/* Define Disk I/O Addresses and Related Constants •/ 

/................... ......./ 

Ideflne DSKITC OxFFOOOO /• irC Base Address */ 

Ideflne DSKINTV 0x3FC /* Address of Disk Interrupt Vector */ 

Ideflne INTTOI PC OxD /* offsets in mem mapped io area •/ 

Ideflne RSTTOIrC OxF 

Idefine HSGTOIPC 0x101 

• define ACKTOIPC 0x103 

Ideflne PKTTOIPC 0x105 

Ideflne MSGFMIPC 0x181 

Idefine ACKFMIPC 0x183 

Ideflne FKTrMIPC 0xlS5 

Ideflne DSKREAD 0x10 /* disk commands */ 

Idefine DSKWRITE 0x20 

/* Some characters used In disk controller packets */ 

Ideflne STX 0x02. . , 

Ideflne ETX 0x03 . , »•.-■•> 

Ideflne ACK 0x08 
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I define NUMDAHS 4 /• Hunger of disks defined •/ 

I define MAXDSK (UUMDSKS-l) /* iukiiuv disk number */ 

BYTE cnvdsklNUMDSKSI - | 4 , S , , 1 ) ; /• convert Cl'/M dskl to EXOHniacs */ 
BYTE rcnvdsk(6| - | 2. i, 0, 0, 0, i |; /* and vice versa ■/ 

/» defines tor IPC and disk states */ 

(define IDLE 

Idefine ACTIVE 1 

WORD ipcstate; /* current IPC state */ 

WORD actvdsk) /* disk number of currently active disk, if any •/ 

LONG intcount) /• count of interrupts needing to be processed */ 



struct dskst | / 

WORD state; /* from defines above */ 

BYTE readyi /* .> not ready •/ 

BYTE chanqej /* «> no change */ 

dskatatelNUMDSKS); 

/ ••* / 

/• Generic Serial Port I/O Procedures •/ 

/ * *'** / / 

/ 

/ / / 

/* Port initialization */ 

/•.••••••••••••• ................/ 

por tin it (pot t) 
REG BYTE 'port; 
1 

•(port ♦ PORTCTRL) - PORTRSET; /* reset the port */ 

•(port ♦ PORTCTRL) - PORTINITi 



/ • * / 

/* Generic serial port status input status •/ 
/** / 

portstat Ipor t) 
REG BYTE "port; 

if ( '(port ^ PORTSTAT) & PORTRDRF) re turn (Oxf f ) ; /• input ready •/ 
else return(OxOO) ; /• not ready •/ 
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Wait lot an ACK from the IPC 



REG WORD imnave; 
REG nYTE work; 



while ( I intcount ) ; /* wait V 

Imsave - set itiwsk (7) j 

Intcount -" 1( 

work - (DSKIPC ♦ ACKmiPC)->bytej 

if ( (work -» ACK) || (work " NAK| ) 

(DSKIPC + ACKFMirC)->byte - 0: 

setimask( imsave| ; 

return(work -- ACK) ; 
I 
setlmask ( Imsave) j 



Acknowledge a message from the IPC 



(DSKIPC * MSGFMIPC)->byte - Oi /* clear message flag */ 
(DSKIPC ♦ ACKTOIFC)->byte - ACK s /• send ACK •/ 

(DSKIPC ♦ INTTOIPC)->byte - 0; /* interrupt IPC »/ 



Send a pack to the IPC 



sendpk tfpktadr , pktslze) 
REG DVTE *pktadt; 
REG WORD pktsliei 

REG BYTE ♦iopackpi 
REG WORD Imsaves 

while ( (DSKIPC»MSGTOIPC)->byte ) ; /* wait til ready */ 
<DSKIPCfACKFMIPC)->byte - Oi 
(DSKIPC«MSGFHIPC)->byte - 0} 
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DIGITAL RESEARCH 
END USER PROGRAM LICENSE AGREEMENT 



NOTICE TO USER - PLEASE READ THIS NOTICE CAREFULLY. DO NOT OPEN THE 
DISKETTE PACKAGE UNTIL YOU HAVE READ THIS LICENSE AGREEMENT. 

OPENING THE DISKETTE PACKAGE INDICATES YOUR AGREEMENT TO BE BOUND BY 
THESE TERMS AND CONDITIONS. IF YOU DO NOT ACCEPT THESE TERMS AND 
CONDITIONS, YOU MUST PROMPTLY RETURN THE PACKAGE UNOPENED TO THE PLACE OF 
ACQUISITION AND YOUR MONEY WILL BE REFUNDED. 



1. DEFINITIONS 

- In this License Agreement, the terms: 

1. DRI means DIGITAL RESEARCH (CALIFORNIA) INC., P.O. Box 579, Pacific Grove, 
California 93950, owner of the copyright in, or authorized licensor of, the 
program. 

2. Machine means the single microcomputer on which you use the program. 
Multiple CPU systems require additional licenses. 

3. Program means the set of programs, documentation and related materials in 
this package, together with all ancillary updates and enhancements supplied 
by DRI to you regardless of the form in which you may subsequently use it, 
and regardless of any modification which you make to it. 

4. AUTHOR means any third party author and owner of the copyright in this 
program. 

You assume responsibility for the selection of the program to achieve your intended 
results, and for the installation, use and results obtained from the program. 

2. LICENSE 

You may: 

1. Use the program on a single machine; 

2. Copy the program into any machine readable or printed form for backup or 
modification purposes in support of your use of the program on a single 
machine. You may make up to three (3) copies of the program for such 
purposes. (Certain programs, however, may include mechanisms to limit or 
inhibit copying. They are marked "copy protected.") Copying of 
documentation and other printed materials is prohibited; 

3. Modify the program and/or merge it into another program for your use on the 
single machine (Any portion of this program merged into another program will 
continue to be subject to the terms and conditions of this Agreement); and, 
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4. Transfer the program and license to another party if You notify DRI of name 
and address of the other party and the other party agrees to a) accept the 
terms and conditions of this Agreement, b) sign and forward to DRI a copy of 
the registration card and c) pay the then current transfer fee. If you transfer 
the program, you must at the same time either transfer all copies, including 
the original, whether in printed or machine readable form to the same party or 
destroy any copies not transferred; this includes all modifications and portions 
of the program contained or merged into other programs. 

You must reproduce and include the copyright notice on any copy, modification or 
portion merged into another program. 

YOU MAY NOT USE, COPY, MODIFY, TRANSFER, OR OTHERWISE MAKE AVAILABLE TO 
ANY THIRD PARTY, THE PROGRAM, OR ANY COPY, MODIFICATION OR MERGED 
PORTION, IN WHOLE OR IN PART, EXCEPT AS EXPRESSLY PROVIDED FOR IN THIS 
LICENSE AGREEMENT. 

IF YOU TRANSFER POSSESSION OF ANY COPY, MODIFICATION OR MERGED PORTION 
OF THE PROGRAM TO ANOTHER PARTY, YOUR LICENSE IS AUTOMATICALLY 
TERMINATED. 



3. TERM 

The license is effective until terminated. You may terminate it at any other time by 
destroying the program together with all copies, modifications and merged portions in 
any form. It will also terminate upon conditions set forth elsewhere in this Agreement or 
if you fail to comply with any term or condition of this Agreement. You agree upon such 
termination to destroy the program together with all copies, modifications and merged 
portions in any form. 



4. LIMITED WARRANTY 

THE PROGRAM IS PROVIDED "AS IS". NEITHER DRI NOR AUTHOR MAKE ANY 
WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT 
LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF 
THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU (AND 
NOT DRI OR AUTHOR) ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING, 
REPAIR OR CORRECTION. 

SOME STATES DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE 
ABOVE EXCLUSION MAY NOT APPLY TO YOU. THIS WARRANTY GIVES YOU SPECIFIC 
LEGAL RIGHTS AND YOU MAY ALSO HAVE OTHER RIGHTS WHICH VARY BY STATE OR 
JURISDICTION. 

Neither DRI nor AUTHOR warrant that the functions contained in the program will meet 
your requirements or that the operation of the program will be uninterrupted or error free. 

However, DRI warrants the diskette(s) on which the program is furnished, to be free 
from defects in materials and workmanship under normal use for a period of ninety (90) 
days from the date of delivery to you as evidenced by a copy of your receipt. 
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5. LIMITATIONS OF REMEDIES 

DRI's entire liability and your exclusive remedy shall be: 

1. The replacement of any diskette not meeting DRI's "Limited Warranty" and 
which is returned to DRI or your place of acquisition with a copy of your 
receipt, or 

2. If DRI or the place of acquisition is unable to deliver a replacement diskette 
which is free of defects in materials or workmanship, you may terminate this 
Agreement by returning the program and your money will be refunded. 

IN NO EVENT SHALL DRI OR AUTHOR BE LIABLE FOR ANY DAMAGES, INCLUDING ANY 
LOST PROFITS, LOST SAVINGS, OR OTHER SPECIAL INDIRECT OR CONSEQUENTIAL 
DAMAGES, EVEN IF DRI OR AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH 
DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY. 

SOME STATES AND JURISDICTIONS DO NOT ALLOW THE LIMITATION OR EXCLUSION 
OF LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES SO THE ABOVE 
LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU. 

6. REGISTRATION CARD 

DRI may from time to time update its programs. Updates will be provided to you only if 
a properly signed registration card is on file at DRI's main office or an authorized 
registration card recipient. DRI is not obligated to make any program updates, or to 
supply any such updates to you. 

7. GENERAL 

You may not sublicense, assign or transfer the license or the program except as 
expressly provided in this Agreement. Any attempt otherwise to sublicense, assign or 
transfer any of the rights, duties or obligations hereunder is void. 

This Agreement will be governed by the laws of the State of California, except as to 
matters of copyright where this Agreement shall be governed by U.S. federal law. You 
and DRI hereby agree to the non-exclusive jurisdiction of the courts in the State of 
California. 

Should you have any questions concerning this Agreement, you may contact DRI by 
writing to Digital Research Inc., P.O. Box 579, Pacific Grove, California 93950. 

THIS AGREEMENT CANNOT AND SHALL NOT BE MODIFIED BY PURCHASE ORDERS, 
ADVERTISING OR OTHER REPRESENTATIONS BY ANYONE, AND MAY ONLY BE MODIFIED 
BY A WRITTEN AMENDMENT EXECUTED BY YOU AND AN AUTHORIZED OFFICER OF DRI. 

YOU ACKNOWLEDGE THAT YOU HAVE READ THIS AGREEMENT, UNDERSTAND IT AND 
AGREE TO BE BOUND BY ITS TERMS AND CONDITIONS. YOU FURTHER AGREE THAT IT 
IS THE COMPLETE AND EXCLUSIVE STATEMENT OF THE AGREEMENT BETWEEN YOU 
AND DRI WHICH SUPERSEDES ANY PROPOSAL OR PRIOR AGREEMENT, ORAL OR 
WRITTEN, AND ANY COMMUNICATIONS BETWEEN YOU AND DRI RELATING TO THE 
SUBJECT MATTER OF THIS AGREEMENT. 
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